PFND3DDDI_GETCAPS Rückruffunktion (d3dumddi.h)

2025-02-06

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

Syntax

PFND3DDDI_GETCAPS Pfnd3dddiGetcaps;

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

Parameter

hAdapter

Ein Handle, das den Grafikadapter 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, damit er abgeschlossen werden kann.

Bemerkungen

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

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

mitglied D3DDDIARG_GETCAPS	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)
Notizen	Der Treiber muss die DDRAW_CAPS Struktur mit den unterstützten DirectDraw-Funktionen ausfüllen.	Der Treiber muss den Puffer ausfüllen, auf den pData- mit einem UINT-Wert verweist, der die Anzahl der vom Gerät unterstützten D3DDDIFORMAT Oberflächenformate darstellt.

Erläuterungen zu anderen Werten für D3DDDIARG_GETCAPS finden Sie unter D3DDDIARG_GETCAPS. Geben Sie ein, die für Mehrplanüberlagerungen verwendet werden.

Simple_instancing

Wenn ein Direct3D Level 9-Treiber, der das Windows Display Driver Model (WDDM) 1.3 (WDDM) unterstützt, einen Aufruf von PFND3DDDI_GETCAPS abschließt und S_OK zurückgibt, die Daten in der D3DDDIARG_GETCAPS-Struktur jedoch nicht ändert, wird an die Direct3D-Laufzeit angegeben, dass die Hardware und der Treiber keine einfache Instancing unterstützen. Weitere Informationen finden Sie unter D3DDDICAPS_SIMPLE_INSTANCING_SUPPORT.