structure DD_GETDRIVERSTATEDATA (ddrawint.h)

Article
08/23/2023

La structure DD_GETDRIVERSTATEDATA décrit l’état du pilote.

Syntaxe

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

Membres

dwFlags

Spécifie le jeu d’indicateurs pour indiquer les données demandées. Ce paramètre peut être défini sur l’un des indicateurs suivants :

Indicateur	Signification
D3DDEVINFOID_D3DTEXTUREMANAGER	Demande des informations de gestion de texture effectuées par le runtime Direct3D dans une structure de D3DDEVINFO_TEXTUREMANAGER.
D3DDEVINFOID_TEXTUREMANAGER	Demande des informations de gestion de texture effectuées par le pilote ou le runtime Direct3D dans une structure de D3DDEVINFO_TEXTUREMANAGER.
D3DDEVINFOID_TEXTURING	Demande des informations d’activité de texture de l’application dans une structure D3DDEVINFO_TEXTURING.
D3DDEVINFOID_VCACHE	Versions de DirectX 8.1 uniquement Demande des informations sur le cache de vertex dans une structure de D3DDEVINFO_VCACHE.

lpDD

Pointe vers une structure DD_DIRECTDRAW_GLOBAL décrivant l’appareil.

dwhContext

Spécifie l’ID du contexte pour lequel les informations sont demandées.

lpdwStates

Pointe vers les données d’état du pilote Direct3D à renseigner par le pilote. Si, par exemple, D3DDEVINFOID_VCACHE est spécifié dans le membre dwFlags , le pilote pointe le membre lpdwStates vers une structure D3DDEVINFO_VCACHE qui contient des informations de cache de vertex.

dwLength

Spécifie la longueur, en octets, des données d’état à remplir par le pilote.

ddRVal

Spécifie l’emplacement où le pilote écrit la valeur de retour du rappel D3dGetDriverState . Un code de retour de D3D_OK indique la réussite. Pour plus d’informations, consultez Codes de retour pour les rappels de pilotes Direct3D.

Notes

Les applications peuvent utiliser la méthode IDirect3DDevice7::GetInfo et spécifier les indicateurs D3DDEVINFOID_D3DTEXTUREMANAGER, D3DDEVINFOID_TEXTUREMANAGER et D3DDEVINFOID_TEXTURING pour récupérer des informations de texturation. Pour plus d’informations sur cette méthode et les structures associées à ces indicateurs, consultez la documentation du Kit de développement logiciel (SDK) DirectX. Le runtime transmet ensuite ces indicateurs au pilote.

Versions de DirectX 8.1 uniquement.Le runtime Direct3D spécifie l’indicateur D3DDEVINFOID_VCACHE dans le membre dwFlags pour récupérer les informations de vertex-cache à partir du pilote spécifié au niveau du membre lpDD . Le pilote spécifie ces informations dans une structure D3DDEVINFO_VCACHE et les retourne au membre lpdwStates .

DirectX 9.0 et versions ultérieures uniquement. Le runtime Direct3D interroge de manière asynchrone le pilote pour obtenir des informations sur le cache de vertex à l’aide des commandes D3DDP2OP_CREATEQUERY et D3DDP2OP_ISSUEQUERY et du type de requête D3DQUERYTYPE_VCACHE dans les appels au rappel D3dDrawPrimitives2 du pilote. Pour plus d’informations, consultez D3DDEVINFO_VCACHE.

Note L’indicateur D3DDEVINFOID_VCACHE est défini dans d3dhal.h ; les autres indicateurs qui peuvent être définis dans dwFlags sont définis dans d3dtypes.h.