PFND3DDDI_CREATECONTEXTCB Rückruffunktion (d3dumddi.h)
Die pfnCreateContextCb Rückruffunktion der Direct3D-Laufzeit erstellt einen Kontext.
Syntax
PFND3DDDI_CREATECONTEXTCB Pfnd3dddiCreatecontextcb;
HRESULT Pfnd3dddiCreatecontextcb(
HANDLE hDevice,
D3DDDICB_CREATECONTEXT *unnamedParam2
)
{...}
Parameter
hDevice
[in] Behandeln Sie das Gerät, für das der Kontext erstellt werden soll.
unnamedParam2
[in/out] Zeigen Sie auf eine D3DDDICB_CREATECONTEXT Struktur, die der Treiber mit den erforderlichen Informationen zum Erstellen des Kontexts ausfüllt. Diese Struktur enthält Details wie Knoten ordinal, Modulaffinität und Flags, die das Verhalten und die Funktionen des zu erstellenden Kontexts angeben. Nach erfolgreichem Abschluss aktualisiert die Laufzeit diese Struktur mit Informationen zum neu erstellten Kontext.
Rückgabewert
pfnCreateContextCb gibt ein HRESULT zurück, um den Erfolg oder Fehler der Kontexterstellungsanforderung anzugeben. Zu den allgemeinen Rückgabewerten gehören:
| Rückgabecode | Bedeutung |
|---|---|
| S_OK | Der Kontext wurde erfolgreich erstellt. |
| E_OUTOFMEMORY | Es ist nicht genügend Arbeitsspeicher vorhanden, um den Kontext zu erstellen. |
| E_INVALIDARG | Mindestens eines der bereitgestellten Argumente ist ungültig. |
Bemerkungen
Der Benutzermodusanzeigetreiber (USER-Mode Display Driver, UMD) muss explizit pfnCreateContextCb aus seiner CreateDevice Implementierung aufrufen, um einen GPU-Kontext zu erstellen, der dem Gerät zugeordnet ist. GPU-Kontexte sind GPU-Threads der Ausführung auf einem neu erstellten Gerät.
Der Kontext kapselt Zustands- und Befehlspuffer, die von der GPU zum Ausführen von Renderingvorgängen verwendet werden. UMD ist für die Verwaltung des Lebenszyklus von Kontexten verantwortlich, die es erstellt, einschließlich ihrer letztendlichen Zerstörung, um Ressourcen freizugeben.
Weitere Informationen zum Erstellen eines Renderinggeräts finden Sie unter Windows Display Driver Model (WDDM)-Vorgangsfluss.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows Vista (WDDM 1.0) |
| Header- | d3dumddi.h |