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