структура D3DDDIARG_OPENADAPTER (d3dumddi.h)

  • Статья

Структура D3DDDIARG_OPENADAPTER содержит сведения, описывающие объект графического адаптера.

Синтаксис

typedef struct _D3DDDIARG_OPENADAPTER {
  [in/out] HANDLE                        hAdapter;
  [in]     UINT                          Interface;
  [in]     UINT                          Version;
  [in]     const D3DDDI_ADAPTERCALLBACKS *pAdapterCallbacks;
  [out]    D3DDDI_ADAPTERFUNCS           *pAdapterFuncs;
  [out]    UINT                          DriverVersion;
} D3DDDIARG_OPENADAPTER;

Члены

[in/out] hAdapter

Дескриптор объекта графического адаптера. При входе в функцию OpenAdapterhAdapter указывает дескриптор, который драйвер должен использовать для запроса возможностей графического адаптера, когда драйвер вызывает функцию обратного вызова pfnQueryAdapterInfoCb , предоставляемую средой выполнения Microsoft Direct3D.

Драйвер создает уникальный дескриптор и передает его обратно в среду выполнения Direct3D. В выходных данных функции OpenAdapterhAdapter указывает дескриптор, который среда выполнения Direct3D использует в последующих вызовах драйвера для идентификации объекта графического адаптера.

[in] Interface

Версия интерфейса Direct3D/DirectDraw (например, 7, 8 или 9), которая открывает графический адаптер.

[in] Version

Число, которое драйвер может использовать для определения времени создания среды выполнения Direct3D/DirectDraw. Например, драйвер может использовать номер версии, чтобы различать среду выполнения, выпущенную с Windows Vista, и среду выполнения, выпущенную с последующим пакетом обновления, который может содержать исправление, необходимое драйверу.

[in] pAdapterCallbacks

Указатель на структуру D3DDDI_ADAPTERCALLBACKS , содержащую функцию обратного вызова pfnQueryAdapterInfoCb , предоставляемую средой выполнения Direct3D, которую может использовать драйвер.

[out] pAdapterFuncs

Указатель на структуру D3DDDI_ADAPTERFUNCS , содержащую таблицу функций адаптера драйвера отображения пользовательского режима. Среда выполнения Direct3D использует эти функции для взаимодействия с драйвером отображения пользовательского режима об операциях, относящихся к графическому адаптеру.

[out] DriverVersion

Версия интерфейса драйвера отображения в пользовательском режиме Direct3D, полученная из файла заголовка D3dumddi.h , с помощью которого был скомпилирован драйвер. Драйвер отображения пользовательского режима должен возвращать D3D_UMD_INTERFACE_VERSION.

Примечание Если драйвер пользовательского режима не поддерживает функции Windows 7 (DXGKDDI_INTERFACE_VERSION < DXGKDDI_INTERFACE_VERSION_WIN7) и вы хотите скомпилировать драйвер с Windows 7 WDK (версия 7600), убедитесь, что драйвер возвращает D3D_UMD_INTERFACE_VERSION_VISTA.
 

Требования

Требование Значение
Минимальная версия клиента Доступно в Windows Vista и более поздних версиях операционных систем Windows.
Верхняя часть d3dumddi.h (включая D3dumddi.h)

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

D3DDDI_ADAPTERCALLBACKS

D3DDDI_ADAPTERFUNCS

OpenAdapter

pfnQueryAdapterInfoCb