структура DD_GETDRIVERSTATEDATA (ddrawint.h)

Статья
08/23/2023

Структура DD_GETDRIVERSTATEDATA описывает состояние драйвера.

Синтаксис

typedef struct _DD_GETDRIVERSTATEDATA {
  DWORD   dwFlags;
  union {
    PDD_DIRECTDRAW_GLOBAL lpDD;
    DWORD_PTR             dwhContext;
  };
  LPDWORD lpdwStates;
  DWORD   dwLength;
  HRESULT ddRVal;
} *PDD_GETDRIVERSTATEDATA, DD_GETDRIVERSTATEDATA;

Члены

dwFlags

Задает набор флагов для указания запрошенных данных. Для этого параметра можно задать один из следующих флагов:

Flag	Значение
D3DDEVINFOID_D3DTEXTUREMANAGER	Запрашивает сведения об управлении текстурами, выполняемые средой выполнения Direct3D в D3DDEVINFO_TEXTUREMANAGER структуре.
D3DDEVINFOID_TEXTUREMANAGER	Запрашивает сведения об управлении текстурами, выполняемые драйвером или средой выполнения Direct3D в структуре D3DDEVINFO_TEXTUREMANAGER.
D3DDEVINFOID_TEXTURING	Запрашивает сведения о действии текстуры приложения в D3DDEVINFO_TEXTURING структуре.
D3DDEVINFOID_VCACHE	Только версии DirectX 8.1 Запрашивает сведения о кэше вершин в D3DDEVINFO_VCACHE структуре.

lpDD

Указывает на DD_DIRECTDRAW_GLOBAL структуру, описывающую устройство.

dwhContext

Указывает идентификатор контекста, для котором запрашиваются сведения.

lpdwStates

Указывает на данные о состоянии драйвера Direct3D, которые должны быть заполнены драйвером. Если, например, в элементе dwFlags указано D3DDEVINFOID_VCACHE, драйвер указывает член lpdwStates на структуру D3DDEVINFO_VCACHE, содержащую сведения о кэше вершин.

dwLength

Указывает длину (в байтах) данных о состоянии, заполняемых драйвером.

ddRVal

Указывает расположение, в которое драйвер записывает возвращаемое значение обратного вызова D3dGetDriverState . Код возврата D3D_OK указывает на успешное выполнение. Дополнительные сведения см. в разделе Коды возврата для обратных вызовов драйвера Direct3D.

Приложения могут использовать метод IDirect3Device7::GetInfo и указывать флаги D3DDEVINFOID_D3DTEXTUREMANAGER, D3DDEVINFOID_TEXTUREMANAGER и D3DDEVINFOID_TEXTURING для получения сведений о форматировании. Дополнительные сведения об этом методе и структурах, связанных с этими флагами, см. в документации по пакету SDK для DirectX. Затем среда выполнения передает эти флаги драйверу.

Только версии DirectX 8.1.Среда выполнения Direct3D задает флаг D3DDEVINFOID_VCACHE в элементе dwFlags для получения сведений о кэше вершин из драйвера, указанного в элементе lpDD . Драйвер указывает эти сведения в структуре D3DDEVINFO_VCACHE и возвращает их в члене lpdwStates .

Только Для DirectX 9.0 и более поздних версий. Среда выполнения Direct3D асинхронно запрашивает у драйвера сведения о кэше вершин с помощью команд D3DDP2OP_CREATEQUERY и D3DDP2OP_ISSUEQUERY и типа запроса D3DQUERYTYPE_VCACHE в вызовах обратного вызова D3dDrawPrimitives2 драйвера. Дополнительные сведения см. в разделе D3DDEVINFO_VCACHE.

Примечание Флаг D3DDEVINFOID_VCACHE определен в d3dhal.h; другие флаги, которые можно задать в dwFlags, определяются в d3dtypes.h.