PFND3DDDI_GETCAPS Rückruffunktion (d3dumddi.h)
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.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Zielplattform | Desktop |
| Kopfzeile | d3dumddi.h (include D3dumddi.h) |