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)

Weitere Informationen

D3D11DDI_DEVICEFUNCS

D3D11DDI_THREADING_CAPS

GetCaps(D3D10_2)

pfnSetErrorCb