Directdraw

Общие сведения о технологии DirectDraw.

Для разработки DirectDraw вам потребуются следующие заголовки:

• ddraw.h

Рекомендации по программированию для этой технологии см. в следующих разделах:

• Directdraw

Функции

AddAttachedSurface Присоединяет к этой поверхности указанную поверхность z-буфера.
AddOverlayDirtyRect Метод IDirectDrawSurface7::AddOverlayDirtyRect в настоящее время не реализован.
Blt Выполняет передачу битового блока (bitblt). Этот метод не поддерживает z-буферизацию или альфа-смешение во время операций bitblt.
BltBatch Метод IDirectDrawSurface7::BltBatch в настоящее время не реализован.
BltFast Выполняет исходное копирование bitblt или transparent bitblt с помощью исходного ключа цвета или ключа цвета назначения.
ChangeUniquenessValue Вручную обновляет значение уникальности для этой поверхности.
Компактный Этот метод в настоящее время не реализован. (IDirectDraw7.Compact)
CreateClipper Создает объект DirectDrawClipper.
CreatePalette Создает объект DirectDrawPalette для этого объекта DirectDraw.
Createsurface Создает объект DirectDrawSurface для этого объекта DirectDraw.
DeleteAttachedSurface Отсоединяет одну или несколько присоединенных поверхностей.
DirectDrawCreate Создает экземпляр объекта DirectDraw.
DirectDrawCreateClipper Создает экземпляр объекта DirectDrawClipper, который не связан с объектом DirectDraw.
DirectDrawCreateEx Создает экземпляр объекта DirectDraw, который поддерживает набор интерфейсов Direct3D в DirectX 7.0. Чтобы использовать функции Direct3D в DirectX 7.0, создайте объект DirectDraw с этой функцией.
DirectDrawEnumerateA Эта функция заменена функцией DirectDrawEnumerateEx. (ANSI)
DirectDrawEnumerateExA Перечисляет все устройства DirectDraw, установленные на компьютере. Запись NULL всегда определяет основное устройство отображения, совместно используемое с GDI. (ANSI)
DirectDrawEnumerateExW Перечисляет все устройства DirectDraw, установленные на компьютере. Запись NULL всегда определяет основное устройство отображения, совместно используемое с GDI. (Юникод)
DirectDrawEnumerateW Эта функция заменена функцией DirectDrawEnumerateEx. (Юникод)
DuplicateSurface Дублирует объект DirectDrawSurface.
EnumAttachedSurfaces Перечисляет все поверхности, прикрепленные к этой поверхности.
EnumDisplayModes Перечисляет все режимы отображения, предоставляемые оборудованием через объект DirectDraw и совместимые с предоставленным описанием поверхности.
EnumOverlayZOrders Перечисляет поверхности наложения в указанном месте назначения. Наложения можно перечислять в порядке от переднего или обратного к переднему.
EnumSurfaces Перечисляет все существующие или возможные поверхности, соответствующие указанному описанию поверхности.
EvaluateMode Используется после вызова метода IDirectDraw7::StartModeTest для передачи или сбоя каждого режима, представленного тестом, и для пошагового выполнения режимов до завершения теста.
Перевернуть Позволяет связать память поверхности, связанную с поверхностью DDSCAPS_BACKBUFFER, с поверхностью переднего буфера.
FlipToGDISurface Создает поверхность, которую GDI записывает в основную поверхность.
FreePrivateData Освобождает указанные личные данные, связанные с этой поверхностью.
GetAttachedSurface Получает присоединенную поверхность, которая имеет указанные возможности, и увеличивает число ссылок полученного интерфейса.
GetAvailableVidMem Извлекает общий объем доступной памяти дисплея и объем памяти дисплея, свободной в данный момент для заданного типа поверхности.
GetBltStatus Получает состояние операции передачи битовых блоков (bitblt).
GetCaps Извлекает возможности драйвера устройства для оборудования и уровня эмуляции оборудования (HEL).
GetCaps Извлекает возможности объекта палитры.
GetCaps Извлекает возможности этой поверхности. Эти возможности не обязательно связаны с возможностями устройства отображения.
GetClipList Извлекает копию списка клипов, связанного с объектом DirectDrawClipper. Чтобы выбрать подмножество списка клипов, можно передать прямоугольник, который обрезает список клипов.
GetClipper Извлекает объект DirectDrawClipper, связанный с этой поверхностью, и увеличивает число ссылок возвращенного клипера.
GetColorControls Извлекает текущие параметры управления цветом, связанные с наложением или основной поверхностью.
GetColorKey Извлекает значение ключа цвета для этой поверхности.
GetDC Создает совместимый с GDI дескриптор контекста устройства для этой поверхности.
GetDDInterface Извлекает интерфейс для объекта DirectDraw, который использовался для создания этой поверхности.
GetDeviceIdentifier Получает сведения о драйвере устройства. Этот метод можно использовать с осторожностью для распознавания конкретных установок оборудования для реализации обходных решений для плохого поведения драйвера или набора микросхем.
GetDisplayMode Извлекает текущий режим отображения.
GetEntries Извлекает значения палитры из объекта DirectDrawPalette.
GetFlipStatus Получает состояние о том, завершила ли эта поверхность процесс переворачивания.
GetFourCCCodes Извлекает коды из четырех символов (FOURCC), поддерживаемые объектом DirectDraw. Этот метод также может получить количество поддерживаемых кодов.
GetGammaRamp Извлекает красные, зеленые и синие гамма-пандусы для основной поверхности.
GetGDISurface Извлекает объект DirectDrawSurface, который в настоящее время представляет память поверхности, которую GDI рассматривает как основную поверхность.
GetHWnd Извлекает дескриптор окна, который ранее был связан с этим объектом DirectDrawClipper методом IDirectDrawClipper::SetHWnd.
GetLOD Извлекает максимальный уровень детализации (LOD), заданный в настоящее время для управляемой поверхности MIP-карты. Этот метод успешно выполняется только для управляемых текстур.
GetMonitorFrequency Извлекает частоту монитора, которым управляет объект DirectDraw.
GetOverlayPosition Извлекает координаты отображения этой поверхности. Этот метод используется на видимой активной поверхности наложения (то есть на поверхности с установленным флагом DDSCAPS_OVERLAY).
GetPalette Извлекает объект DirectDrawPalette, связанный с этой поверхностью, и увеличивает количество ссылок возвращаемой палитры.
GetPixelFormat Извлекает цвет и формат пикселей этой поверхности.
GetPriority Получает приоритет управления текстурами для этой текстуры. Этот метод успешно выполняется только для управляемых текстур.
GetPrivateData Копирует личные данные, связанные с этой поверхностью, в предоставленный буфер.
GetScanLine Извлекает линию сканирования, которая в настоящее время рисуется на мониторе.
GetSurfaceDesc Извлекает описание этой поверхности в ее текущем состоянии.
GetSurfaceFromDC Извлекает интерфейс IDirectDrawSurface7 для поверхности на основе дескриптора контекста устройства GDI.
GetUniquenessValue Извлекает текущее значение уникальности для этой поверхности.
GetVerticalBlankStatus Извлекает состояние вертикального пустого поля.
Initialize Инициализирует объект DirectDraw, созданный с помощью com-функции CoCreateInstance.
Initialize Инициализирует объект DirectDrawClipper, созданный с помощью com-функции CoCreateInstance.
Initialize Инициализирует объект DirectDrawPalette.
Initialize Инициализирует объект DirectDrawSurface.
IsClipListChanged Извлекает состояние списка клипов, если дескриптор окна связан с объектом DirectDrawClipper.
IsLost Определяет, освобождена ли память поверхности, связанная с объектом DirectDrawSurface.
Блокировка Получает указатель на память surface.
LPDDENUMCALLBACKA Функция DDEnumCallback — это определяемая приложением функция обратного вызова для функции DirectDrawEnumerate. (ANSI)
LPDDENUMCALLBACKEXA Функция DDEnumCallbackEx — это определяемая приложением функция обратного вызова для функции DirectDrawEnumerateEx. (ANSI)
LPDDENUMCALLBACKEXW Функция DDEnumCallbackEx — это определяемая приложением функция обратного вызова для функции DirectDrawEnumerateEx. (Юникод)
LPDDENUMCALLBACKW Функция DDEnumCallback — это определяемая приложением функция обратного вызова для функции DirectDrawEnumerate. (Юникод)
LPDDENUMMODESCALLBACK Не используйте. Эта функция обратного вызова заменена функцией EnumModesCallback2, которая используется с методом IDirectDraw7::EnumDisplayModes.
LPDDENUMMODESCALLBACK2 Функция EnumModesCallback2 — это определяемая приложением функция обратного вызова для метода IDirectDraw7::EnumDisplayModes.
LPDDENUMSURFACESCALLBACK Функция LPDDENUMSURFACESCALLBACK (ddraw.h) заменена функцией EnumSurfacesCallback7.
LPDDENUMSURFACESCALLBACK2 Функция LPDDENUMSURFACESCALLBACK2 (ddraw.h) заменена функцией EnumSurfacesCallback7.
LPDDENUMSURFACESCALLBACK7 Функция EnumSurfacesCallback7 — это определяемая приложением функция обратного вызова для методов IDirectDrawSurface7::EnumAttachedSurfaces и IDirectDrawSurface7::EnumOverlayZOrders.
PageLock Предотвращает выгружаемость поверхности системной памяти во время операции передачи битовых блоков (bitblt), которая использует прямой доступ к памяти (DMA) в системную память или из нее.
PageUnlock Разблокирует поверхность системной памяти, которая затем позволяет вытащить ее на страницу.
ReleaseDC Освобождает дескриптор контекста устройства, который ранее был получен с помощью метода IDirectDrawSurface7::GetDC.
Восстановление Восстанавливает потерянную поверхность. Это происходит при освобождении памяти поверхности, связанной с объектом DirectDrawSurface.
RestoreAllSurfaces Восстанавливает все поверхности, созданные для объекта DirectDraw, в том порядке, в который они были созданы.
RestoreDisplayMode Сбрасывает режим оборудования устройства отображения для основной поверхности до вызова метода IDirectDraw7::SetDisplayMode. Для использования этого метода требуется монопольный доступ.
SetClipList Задает или удаляет список клипов, используемый методами IDirectDrawSurface7::Blt, IDirectDrawSurface7::BltBatch и IDirectDrawSurface7::UpdateOverlay на поверхностях, к которым присоединен родительский объект DirectDrawClipper.
SetClipper Присоединяет объект clipper к этой поверхности или удаляет его из нее.
SetColorControls Задает параметры управления цветом для наложения или основной поверхности.
SetColorKey Задает значение ключа цвета для объекта DirectDrawSurface, если оборудование поддерживает цветовые ключи для каждой поверхности.
SetCooperativeLevel Определяет поведение приложения верхнего уровня.
SetDisplayMode Задает режим оборудования устройства отображения.
SetEntries Немедленно изменяет записи в объекте DirectDrawPalette.
SetGammaRamp Задает красный, зеленый и синий гамма-пандусы для основной поверхности.
SetHWnd Задает дескриптор окна, который объект clipper использует для получения сведений об обрезки.
SetLOD Задает максимальный уровень детализации (LOD) для управляемой поверхности MIP-карты. Этот метод выполняется успешно только в управляемых текстурах.
SetOverlayPosition Изменяет координаты отображения поверхности наложения.
SetPalette Присоединяет объект палитры к поверхности (или отсоединяет его от поверхности). Поверхность использует эту палитру для всех последующих операций. Изменение палитры происходит немедленно, без учета времени обновления.
SetPriority Назначает приоритет управления текстурами для этой текстуры. Этот метод выполняется успешно только в управляемых текстурах.
SetPrivateData Связывает данные с поверхностью, которая предназначена для использования приложением, а не DirectDraw. Данные передаются по значению, и несколько наборов данных могут быть связаны с одной поверхностью.
SetSurfaceDesc Задает характеристики существующей поверхности.
StartModeTest Инициирует проверку для обновления системного реестра сведений о частоте обновления для текущего сочетания видеоадаптера и монитора.
TestCooperativeLevel Сообщает текущее состояние устройства DirectDraw на совместном уровне для оконного или полноэкранного приложения.
Unlock Уведомляет DirectDraw о том, что прямые манипуляции с поверхностью завершены.
UpdateOverlay Изменяет положение или изменение визуальных атрибутов поверхности наложения. Для этих поверхностей должен быть установлен флаг DDSCAPS_OVERLAY.
UpdateOverlayDisplay Метод IDirectDrawSurface7::UpdateOverlayDisplay в настоящее время не реализован.
UpdateOverlayZOrder Задает z-порядок наложения.
WaitForVerticalBlank Помогает приложению синхронизироваться с интервалом вертикального пустого интервала.

Интерфейсы

IDirectDraw7 Приложения используют методы интерфейса IDirectDraw7 для создания объектов DirectDraw и работы с переменными системного уровня. В этом разделе содержится ссылка на методы интерфейса IDirectDraw7.
IDirectDrawClipper Приложения используют методы интерфейса IDirectDrawClipper для управления списками клипов. В этом разделе приведена ссылка на методы этого интерфейса.
IDirectDrawColorControl Приложения используют методы интерфейса IDirectDrawColorControl для получения и задания элементов управления цветом.
IDirectDrawGammaControl Приложения используют методы интерфейса IDirectDrawGammaControl для настройки красного, зеленого и синего уровней гамма-пандуса основной поверхности. В этом разделе приведена ссылка на методы этого интерфейса.
IDirectDrawPalette Приложения используют методы интерфейса IDirectDrawPalette для создания объектов DirectDrawPalette и работы с переменными системного уровня. В этом разделе приведена ссылка на методы этого интерфейса.
IDirectDrawSurface7 Приложения используют методы интерфейса IDirectDrawSurface7 для создания объектов DirectDrawSurface и работы с переменными системного уровня. В этом разделе приведена ссылка на методы этого интерфейса.

Структуры

DDCOLORCONTROL Структура DDCOLORCONTROL определяет элементы управления цветом, связанные с объектом расширений видеопорта Microsoft DirectDraw (VPE).
DDSURFACEDESC Структура DDSURFACEDESC содержит описание поверхности, создаваемой драйвером.
DDSURFACEDESC2 Структура DDSURFACEDESC2 содержит описание поверхности, создаваемой драйвером.
DDBLTBATCH Структура DDBLTBATCH передает операции передачи битов (bitblt) методу IDirectDrawSurface7::BltBatch.
DDBLTFX Структура DDBLTFX передает растровые операции (ROPS), эффекты и сведения о переопределении в метод IDirectDrawSurface7::Blt. Эта структура также является частью структуры DDBLTBATCH, которая используется с методом IDirectDrawSurface7::BltBatch.
DDCAPS_DX3 Структура DDCAPS_DX3 (ddraw.h) представляет возможности оборудования, предоставляемого через объект DirectDraw.
DDCAPS_DX5 Структура DDCAPS_DX5 (ddraw.h) представляет возможности оборудования, предоставляемого через объект DirectDraw.
DDCAPS_DX6 Структура DDCAPS_DX6 (ddraw.h) представляет возможности оборудования, предоставляемого через объект DirectDraw.
DDCAPS_DX7 Структура DDCAPS_DX7 (ddraw.h) представляет возможности оборудования, предоставляемого через объект DirectDraw.
DDCOLORKEY Структура DDCOLORKEY описывает исходный ключ цвета, цвет назначения или цветовое пространство.
DDDEVICEIDENTIFIER2 Структура DDDEVICEIDENTIFIER2 передается в метод IDirectDraw7::GetDeviceIdentifier для получения сведений об устройстве.
DDGAMMARAMP Структура DDGAMMARAMP содержит красные, зеленые и синие данные рампы для методов IDirectDrawGammaControl::GetGammaRamp и IDirectDrawGammaControl::SetGammaRamp.
DDOVERLAYFX Структура DDOVERLAYFX передает сведения о наложении методу IDirectDrawSurface7::UpdateOverlay.
DDPIXELFORMAT Структура DDPIXELFORMAT описывает формат пикселей объекта DirectDrawSurface для метода IDirectDrawSurface7::GetPixelFormat.
DDSCAPS Структура DDSCAPS определяет возможности поверхностного объекта Microsoft DirectDraw.
DDSCAPS2 Структура DDSCAPS2 определяет дополнительные возможности поверхностного объекта Microsoft DirectDraw.