estrutura DD_GETDRIVERSTATEDATA (ddrawint.h)

Artigo
08/23/2023

A estrutura DD_GETDRIVERSTATEDATA descreve o estado do driver.

Sintaxe

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

Membros

dwFlags

Especifica o conjunto de sinalizadores para indicar os dados solicitados. Esse parâmetro pode ser definido como um dos seguintes sinalizadores:

Sinalizador	Significado
D3DDEVINFOID_D3DTEXTUREMANAGER	Solicita informações de gerenciamento de textura executadas pelo runtime do Direct3D em uma estrutura D3DDEVINFO_TEXTUREMANAGER.
D3DDEVINFOID_TEXTUREMANAGER	Solicita informações de gerenciamento de textura executadas pelo driver ou pelo runtime do Direct3D em uma estrutura D3DDEVINFO_TEXTUREMANAGER.
D3DDEVINFOID_TEXTURING	Solicita informações de atividade de textura do aplicativo em uma estrutura D3DDEVINFO_TEXTURING.
D3DDEVINFOID_VCACHE	Somente versões do DirectX 8.1 Solicita informações de cache de vértice em uma estrutura de D3DDEVINFO_VCACHE.

lpDD

Aponta para uma estrutura DD_DIRECTDRAW_GLOBAL que descreve o dispositivo.

dwhContext

Especifica a ID do contexto para o qual as informações estão sendo solicitadas.

lpdwStates

Aponta para os dados de estado do driver Direct3D a serem preenchidos pelo driver. Se, por exemplo, D3DDEVINFOID_VCACHE for especificado no membro dwFlags , o driver apontará o membro lpdwStates para uma estrutura D3DDEVINFO_VCACHE que contém informações de cache de vértice.

dwLength

Especifica o comprimento, em bytes, dos dados de estado a serem preenchidos pelo driver.

ddRVal

Especifica o local em que o driver grava o valor retornado do retorno de chamada D3dGetDriverState . Um código de retorno de D3D_OK indica êxito. Para obter mais informações, consulte Retornar códigos para retornos de chamada do driver Direct3D.

Comentários

Os aplicativos podem usar o método IDirect3DDevice7::GetInfo e especificar os sinalizadores D3DDEVINFOID_D3DTEXTUREMANAGER, D3DDEVINFOID_TEXTUREMANAGER e D3DDEVINFOID_TEXTURING para recuperar informações de texturização. Para obter mais informações sobre esse método e as estruturas relacionadas a esses sinalizadores, consulte a documentação do SDK do DirectX. Em seguida, o runtime passa esses sinalizadores para o driver.

Somente versões do DirectX 8.1.O runtime do Direct3D especifica o sinalizador D3DDEVINFOID_VCACHE no membro dwFlags para recuperar informações de cache de vértice do driver especificado no membro lpDD . O driver especifica essas informações em uma estrutura D3DDEVINFO_VCACHE e as retorna no membro lpdwStates .

Somente o DirectX 9.0 e versões posteriores. O runtime do Direct3D consulta de forma assíncrona o driver para obter informações de cache de vértice usando os comandos D3DDP2OP_CREATEQUERY e D3DDP2OP_ISSUEQUERY e o tipo de consulta D3DQUERYTYPE_VCACHE em chamadas para o retorno de chamada D3dDrawPrimitives2 do driver. Para obter mais informações, consulte D3DDEVINFO_VCACHE.

Nota O sinalizador D3DDEVINFOID_VCACHE é definido em d3dhal.h; os outros sinalizadores que podem ser definidos em dwFlags são definidos em d3dtypes.h.