PFND3D11DDI_RECYCLECOMMANDLIST Rückruffunktion (d3d10umddi.h)
Die RecycleCommandList-Funktion verwendet eine Befehlsliste.
Syntax
PFND3D11DDI_RECYCLECOMMANDLIST Pfnd3d11ddiRecyclecommandlist;
void Pfnd3d11ddiRecyclecommandlist(
D3D10DDI_HDEVICE unnamedParam1,
D3D11DDI_HCOMMANDLIST unnamedParam2
)
{...}
Parameter
unnamedParam1
hDevice [in]
Ein Handle für das Anzeigegerät (Grafikkontext).
unnamedParam2
hCommandList [in]
Ein sofortiges Kontexthandle für die privaten Daten des Treibers, damit die Befehlsliste wiederverwendet werden kann.
Rückgabewert
Keine
Bemerkungen
Der Treiber kann die Rückruffunktion pfnSetErrorCb verwenden, um einen Fehlercode festzulegen.
Der Treiber muss nur RecycleCommandList implementieren, wenn der Treiber das bit D3D11DDICAPS_COMMANDLISTS_BUILD_2 Threadingfunktion unterstützt. Der Treiber kann D3D11DDICAPS_COMMANDLISTS_BUILD_2 im Caps-Member der D3D11DDI_THREADING_CAPS-Struktur aus einem Aufruf der GetCaps(D3D10_2)- Funktion des Treibers zurückgeben.
Weitere Informationen zu RecycleCommandList finden Sie unter Optimization for Small Command Listen.
Für den Treiber sollte mit Ausnahme von D3DDDIERR_DEVICEREMOVED kein Fehler auftreten. Wenn der Treiber bei einem Aufruf der pfnSetErrorCb-Funktion einen Fehler mit Ausnahme von D3DDDIERR_DEVICEREMOVED übergibt, ermittelt die Direct3D-Runtime daher, dass der Fehler kritisch ist. Selbst wenn das Gerät entfernt wird, muss der Treiber nicht D3DDDIERR_DEVICEREMOVED zurückgeben. Wenn die Geräteentfernung jedoch den Vorgang von RecycleCommandList beeinträchtigt (was normalerweise nicht geschehen sollte), kann der Treiber D3DDDIERR_DEVICEREMOVED zurückgeben.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | RecycleCommandList wird ab dem Windows 7-Betriebssystem unterstützt. |
| Zielplattform | Desktop |
| Kopfzeile | d3d10umddi.h (include D3d10umddi.h) |