estructura DD_GETDRIVERSTATEDATA (ddrawint.h)

Artículo
08/23/2023

La estructura DD_GETDRIVERSTATEDATA describe el estado del controlador.

Sintaxis

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

Miembros

dwFlags

Especifica el conjunto de marcas para indicar los datos solicitados. Este parámetro se puede establecer en una de las marcas siguientes:

Marca	Significado
D3DDEVINFOID_D3DTEXTUREMANAGER	Solicita información de administración de texturas realizada por el entorno de ejecución de Direct3D en una estructura de D3DDEVINFO_TEXTUREMANAGER.
D3DDEVINFOID_TEXTUREMANAGER	Solicita información de administración de texturas realizada por el controlador o el entorno de ejecución de Direct3D en una estructura de D3DDEVINFO_TEXTUREMANAGER.
D3DDEVINFOID_TEXTURING	Solicita información de la actividad de textura de la aplicación en una estructura de D3DDEVINFO_TEXTURING.
D3DDEVINFOID_VCACHE	Solo versiones de DirectX 8.1 Solicita información de caché de vértices en una estructura de D3DDEVINFO_VCACHE.

lpDD

Apunta a una estructura de DD_DIRECTDRAW_GLOBAL que describe el dispositivo.

dwhContext

Especifica el identificador del contexto para el que se solicita información.

lpdwStates

Apunta a los datos de estado del controlador de Direct3D que el controlador rellenará. Si, por ejemplo, D3DDEVINFOID_VCACHE se especifica en el miembro dwFlags , el controlador apunta el miembro lpdwStates a una estructura de D3DDEVINFO_VCACHE que contiene información de caché de vértices.

dwLength

Especifica la longitud, en bytes, de los datos de estado que rellenará el controlador.

ddRVal

Especifica la ubicación donde el controlador escribe el valor devuelto de la devolución de llamada D3dGetDriverState . Un código de retorno de D3D_OK indica que se ha realizado correctamente. Para obtener más información, consulta Códigos de retorno para devoluciones de llamada del controlador de Direct3D.

Comentarios

Las aplicaciones pueden usar el método IDirect3DDevice7::GetInfo y especificar las marcas de D3DDEVINFOID_D3DTEXTUREMANAGER, D3DDEVINFOID_TEXTUREMANAGER y D3DDEVINFOID_TEXTURING para recuperar información de texturing. Para obtener más información sobre este método y las estructuras relacionadas con estas marcas, consulte la documentación del SDK de DirectX. A continuación, el tiempo de ejecución pasa estas marcas al controlador.

Solo versiones de DirectX 8.1.El tiempo de ejecución de Direct3D especifica la marca D3DDEVINFOID_VCACHE en el miembro dwFlags para recuperar la información de caché de vértices del controlador especificado en el miembro lpDD . El controlador especifica esta información en una estructura de D3DDEVINFO_VCACHE y la devuelve en el miembro lpdwStates .

DirectX 9.0 y versiones posteriores solo. El tiempo de ejecución de Direct3D consulta de forma asincrónica el controlador para obtener información de caché de vértices mediante los comandos D3DDP2OP_CREATEQUERY y D3DDP2OP_ISSUEQUERY y el tipo de consulta D3DQUERYTYPE_VCACHE en las llamadas a la devolución de llamada D3dDrawPrimitives2 del controlador. Para obtener más información, consulte D3DDEVINFO_VCACHE.

Nota La marca D3DDEVINFOID_VCACHE se define en d3dhal.h; Las demás marcas que se pueden establecer en dwFlags se definen en d3dtypes.h.