Трухильо Стэн
Шрифт:
Вся инициализация DirectDraw выполняется в функции OnCreate (при поддержке нескольких вспомогательных функций). Процесс инициализации состоит из семи этапов:
• Получение списка всех драйверов DirectDraw.
• Выбор драйвера DirectDraw.
• Инициализация DirectDraw с использованием выбранного драйвера.
• Получение списка поддерживаемых видеорежимов.
• Выбор исходного видеорежима.
• Активизация выбранного видеорежима.
• Создание поверхностей приложения.
Все эти этапы рассматриваются в последующих разделах.
Функция DirectDrawEnumerate предназначена для составления списка доступных драйверов DirectDraw. Чаще всего обнаруживается всего один драйвер DirectDraw — тот, который управляет установленной видеокартой. Тем не менее в некоторых конфигурациях может присутствовать несколько видеоустройств. В таких случаях DirectDrawEnumerate покажет отдельный драйвер для каждого видеоустройства, поддерживаемого DirectDraw.
Функция DirectDrawEnumerate получает два аргумента: указатель на косвенно вызываемую (callback) функцию и указатель на данные, определяемые приложением, которые передаются этой функции при вызове. В нашем случае аргументами являются косвенно вызываемая функция DriverAvailable и указатель на класс DirectDrawWin (this). Функция DriverAvailable определяется так:
Сначала указатель на данные, определяемые приложением (p), преобразуется в указатель на класс DirectDrawWin (win). Поскольку функция DriverAvailable объявлена как статическая (косвенно вызываемые функции обязаны быть статическими), на нее в отличие от обычных функций класса не распространяются правила автоматического доступа; соответственно доступ к переменным и функциям класса приходится осуществлять через указатель win.
DirectDraw вызывает функцию DriverAvailable один раз для каждого обнаруженного драйвера. При каждом вызове передаются три информационных объекта: GUID, описание и имя. GUID (глобально-уникальный идентификатор) однозначно идентифицирует драйвер. Описание и имя представляют собой строки для неформальной идентификации драйвера. Функция DriverAvailable сохраняет сведения о каждом драйвере в массиве с именем driver и отслеживает количество драйверов в переменной totaldrivers. Наконец, функция DriverAvailable возвращает DDNUMRET_OK, показывая, что перечисление драйверов должно продолжаться. При получении кода возврата DDENUMRET_CANCEL DirectDraw прекращает перечисление драйверов.