PFND3DDDI_GETCAPS Rückruffunktion (d3dumddi.h)

Artikel
02/23/2024

Die D3D-Runtime ruft die PFND3DDDI_GETCAPS Rückruffunktion des Treibers auf, um die Funktionen des Grafikkartes abzufragen.

Syntax

PFND3DDDI_GETCAPS Pfnd3dddiGetcaps;

HRESULT Pfnd3dddiGetcaps(
  HANDLE hAdapter,
  const D3DDDIARG_GETCAPS *unnamedParam2
)
{...}

Parameter

hAdapter

Ein Handle, das den Grafikkarten identifiziert.

unnamedParam2

pData [in, out]

Ein Zeiger auf eine D3DDDIARG_GETCAPS-Struktur , die die abzurufenden Funktionen beschreibt.

Rückgabewert

PFND3DDDI_GETCAPS gibt einen der folgenden Werte zurück:

Rückgabecode	Beschreibung
S_OK	Die Funktionen wurden erfolgreich abgerufen.
E_OUTOFMEMORY	PFND3DDDI_GETCAPS konnte den erforderlichen Arbeitsspeicher nicht zuordnen.

Hinweise

Die im pData-Member der D3DDDIARG_GETCAPS-Struktur zurückgegebenen Daten hängen vom Typ der angeforderten Daten ab (d. h. die Daten hängen von D3DDDIARG_GETCAPS ab. Geben Sie und manchmal auf das pInfo-Element ein.

Die folgende Tabelle enthält zwei Beispiele für das Einrichten des PFND3DDDI_GETCAPS Aufrufs abhängig vom Wert von D3DDDIARG_GETCAPS. Geben Sie ein.

D3DDDIARG_GETCAPS-Mitglied	Beispiel 1	Beispiel 2
Typ	D3DDDICAPS_DDRAW	D3DDDICAPS_GETFORMATCOUNT
Pinfo	[in] NULL (keine Bedingungen festgelegt)	[in] NULL (keine Bedingungen festgelegt)
Pdata	[out] DDRAW_CAPS (eindeutiger Zeiger)	[out] UINT* (eindeutiger Zeiger)
DataSize	sizeof(DDRAW_CAPS)	sizeof(UINT)
Hinweise	Der Treiber muss die DDRAW_CAPS-Struktur mit den unterstützten DirectDraw-Funktionen füllen.	Der Treiber muss den Puffer, auf den pData verweist, mit einem UINT-Wert füllen, der die Anzahl der D3DDDIFORMAT Oberflächenformate darstellt, die das Gerät unterstützt.

Erläuterungen zu anderen Werten für D3DDDIARG_GETCAPS finden Sie unter D3DDDIARG_GETCAPS. Typ , der für Mehrplanenüberlagerungen verwendet wird.

Simple_instancing

Wenn ein Direct3D Level 9-Treiber, der WDDM (Windows Display Driver Model) 1.3 und höher unterstützt, einen Aufruf von PFND3DDDI_GETCAPS abschließt und S_OK zurückgibt, aber die Daten in der D3DDDIARG_GETCAPS-Struktur nicht ändert, gibt er der Direct3D-Runtime an, dass die Hardware und der Treiber keine einfache Instanziierung unterstützen. Weitere Informationen finden Sie unter D3DDDICAPS_SIMPLE_INSTANCING_SUPPORT.