Поделиться через

структура 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 (включая D3dumddi.h)

См. также раздел

CreateDevice

D3DDDI_CREATEDEVICEFLAGS

D3DDDI_DEVICECALLBACKS

D3DDDI_DEVICEFUNCS

DxgkDdiCreateDevice