структура D3DDDIARG_CREATEDEVICE (d3dumddi.h)
Структура D3DDDIARG_CREATEDEVICE содержит сведения, описывающие создаваемое устройство отображения.
Синтаксис
typedef struct _D3DDDIARG_CREATEDEVICE {
[in/out] HANDLE hDevice;
[in] UINT Interface;
[in] UINT Version;
[in] const D3DDDI_DEVICECALLBACKS *pCallbacks;
[in] VOID *pCommandBuffer;
[in] UINT CommandBufferSize;
[in] D3DDDI_ALLOCATIONLIST *pAllocationList;
[in] UINT AllocationListSize;
[in] D3DDDI_PATCHLOCATIONLIST *pPatchLocationList;
[in] UINT PatchLocationListSize;
D3DDDI_DEVICEFUNCS *pDeviceFuncs;
[in] D3DDDI_CREATEDEVICEFLAGS Flags;
D3DGPU_VIRTUAL_ADDRESS CommandBuffer;
} D3DDDIARG_CREATEDEVICE;
Члены
[in/out] hDevice
Дескриптор устройства отображения (графический контекст). При входе в функцию CreateDevicehDevice указывает дескриптор, который драйвер должен использовать при обратном вызове в среду выполнения Microsoft Direct3D.
Драйвер создает уникальный дескриптор и передает его обратно в среду выполнения Direct3D. В выходных данных функции CreateDevicehDevice указывает дескриптор, используемый средой выполнения Direct3D в последующих вызовах драйвера для идентификации устройства отображения.
[in] Interface
Версия интерфейса Direct3D/DirectDraw (например, 7, 8 или 9), которая создает устройство.
[in] Version
Число, которое драйвер может использовать для идентификации при создании среды выполнения Direct3D/DirectDraw. Например, драйвер может использовать номер версии, чтобы различать среду выполнения, выпущенную в Windows Vista, и среду выполнения, выпущенную с последующим пакетом обновления, который может содержать исправление, которое требует драйвер.
[in] pCallbacks
Указатель на структуру D3DDDI_DEVICECALLBACKS, содержащую таблицу функций обратного вызова среды выполнения Direct3D, которые драйвер может использовать.
[in] pCommandBuffer
Устаревший. Чтобы получить указатель на первый буфер, который драйвер отображения пользовательского режима может использовать для пакетных команд, драйвер должен сначала вызвать функцию pfnCreateContextCb, чтобы создать контекст для созданного устройства.
[in] CommandBufferSize
Устаревший.
[in] pAllocationList
Устаревший. Чтобы получить массив структур D3DDDI_ALLOCATIONLIST для начального списка выделения, драйвер должен сначала вызвать функцию pfnCreateContextCb, чтобы создать контекст для только что созданного устройства.
[in] AllocationListSize
Устаревший.
[in] pPatchLocationList
Устаревший. Чтобы получить массив структур D3DDDI_PATCHLOCATIONLIST для начального списка исправлений, драйвер должен сначала вызвать функцию pfnCreateContextCb, чтобы создать контекст для только что созданного устройства.
[in] PatchLocationListSize
Устаревший.
pDeviceFuncs
[out] Указатель на структуру D3DDDI_DEVICEFUNCS, заполняемую драйвером в пользовательском режиме, таблицей ее функций. Среда выполнения Direct3D использует эти функции для взаимодействия с драйвером отображения в пользовательском режиме.
[in] Flags
Структура D3DDDI_CREATEDEVICEFLAGS, которая определяет, как создать устройство.
CommandBuffer
Этот элемент зарезервирован и должен иметь значение нулю.
Этот член доступен начиная с Windows 7.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Доступно в Windows Vista и более поздних версиях операционных систем Windows. |
| заголовка | d3dumddi.h (include D3dumddi.h) |