DD_GETDRIVERSTATEDATA-Struktur (ddrawint.h)

Artikel
08/23/2023

Die DD_GETDRIVERSTATEDATA-Struktur beschreibt den Zustand des Treibers.

Syntax

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

Member

dwFlags

Gibt den Satz von Flags an, um die angeforderten Daten anzugeben. Dieser Parameter kann auf eines der folgenden Flags festgelegt werden:

Flag	Bedeutung
D3DDEVINFOID_D3DTEXTUREMANAGER	Fordert Texturverwaltungsinformationen an, die von der Direct3D-Runtime in einer D3DDEVINFO_TEXTUREMANAGER-Struktur ausgeführt werden.
D3DDEVINFOID_TEXTUREMANAGER	Fordert Texturverwaltungsinformationen an, die entweder vom Treiber oder der Direct3D-Runtime in einer D3DDEVINFO_TEXTUREMANAGER-Struktur ausgeführt werden.
D3DDEVINFOID_TEXTURING	Fordert Texturaktivitätsinformationen der Anwendung in einer D3DDEVINFO_TEXTURING-Struktur an.
D3DDEVINFOID_VCACHE	Nur DirectX 8.1-Versionen Fordert Vertexcacheinformationen in einer D3DDEVINFO_VCACHE-Struktur an.

lpDD

Zeigt auf eine DD_DIRECTDRAW_GLOBAL-Struktur , die das Gerät beschreibt.

dwhContext

Gibt die ID des Kontexts an, für den Informationen angefordert werden.

lpdwStates

Verweist auf die Direct3D-Treiberstatusdaten, die vom Treiber ausgefüllt werden sollen. Wenn beispielsweise D3DDEVINFOID_VCACHE im dwFlags-Member angegeben wird, verweist der Treiber den lpdwStates-Member auf eine D3DDEVINFO_VCACHE-Struktur, die Vertex-Cache-Informationen enthält.

dwLength

Gibt die Länge der Vom Treiber auszufüllenden Zustandsdaten in Bytes an.

ddRVal

Gibt den Speicherort an, an dem der Treiber den Rückgabewert des D3dGetDriverState-Rückrufs schreibt. Ein Rückgabecode von D3D_OK zeigt den Erfolg an. Weitere Informationen finden Sie unter Rückgabecodes für Direct3D-Treiberrückrufe.

Hinweise

Anwendungen können die IDirect3DDevice7::GetInfo-Methode verwenden und die flags D3DDEVINFOID_D3DTEXTUREMANAGER, D3DDEVINFOID_TEXTUREMANAGER und D3DDEVINFOID_TEXTURING angeben, um Texturinformationen abzurufen. Weitere Informationen zu dieser Methode und zu den Strukturen im Zusammenhang mit diesen Flags finden Sie in der Dokumentation zum DirectX SDK. Die Runtime übergibt diese Flags dann an den Treiber.

Nur DirectX 8.1-Versionen.Die Direct3D-Runtime gibt das D3DDEVINFOID_VCACHE-Flag im dwFlags-Member an, um Vertexcacheinformationen aus dem treiber abzurufen, der im lpDD-Member angegeben ist. Der Treiber gibt diese Informationen in einer D3DDEVINFO_VCACHE-Struktur an und gibt sie am lpdwStates-Element zurück.

Nur DirectX 9.0 und höhere Versionen. Die Direct3D-Runtime fragt den Treiber asynchron nach Vertexcacheinformationen ab, indem sie die Befehle D3DDP2OP_CREATEQUERY und D3DDP2OP_ISSUEQUERY und den D3DQUERYTYPE_VCACHE Abfragetyp in Aufrufen des D3dDrawPrimitives2-Rückrufs des Treibers verwendet. Weitere Informationen finden Sie unter D3DDEVINFO_VCACHE.

Hinweis Das D3DDEVINFOID_VCACHE-Flag ist in d3dhal.h definiert; die anderen Flags, die in dwFlags festgelegt werden können, sind in d3dtypes.h definiert.