PFND3D11DDI_DESTROYCOMMANDLIST Rückruffunktion (d3d10umddi.h)

Artikel
02/26/2024

Die DestroyCommandList-Funktion zerstört eine Befehlsliste.

Syntax

PFND3D11DDI_DESTROYCOMMANDLIST Pfnd3d11ddiDestroycommandlist;

void Pfnd3d11ddiDestroycommandlist(
  D3D10DDI_HDEVICE unnamedParam1,
  D3D11DDI_HCOMMANDLIST unnamedParam2
)
{...}

Parameter

unnamedParam1

hDevice [in]

Ein Handle für das Anzeigegerät (Grafikkontext).

unnamedParam2

hCommandList [in]

Ein Handle für die privaten Daten des Treibers, damit die Befehlsliste zerstört werden kann. Die Microsoft Direct3D-Runtime gibt den Arbeitsspeicherbereich frei, den sie zuvor für die Befehlsliste zugewiesen hat. Daher kann der Treiber nicht mehr auf diesen Speicherbereich zugreifen.

Rückgabewert

Keine

Bemerkungen

Der Treiber kann die Rückruffunktion pfnSetErrorCb verwenden, um einen Fehlercode festzulegen.

Der Treiber muss DestroyCommandList nur implementieren, wenn der Treiber die D3D11DDICAPS_COMMANDLISTS_BUILD_2-Funktion unterstützt, die in der D3D11DDI_THREADING_CAPS-Struktur von einem Aufruf der GetCaps(D3D10_2)- Funktion zurückgegeben werden kann.

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 DestroyCommandList beeinträchtigt (was normalerweise nicht geschehen sollte), kann der Treiber D3DDDIERR_DEVICEREMOVED zurückgeben.

Der Treiber kann eine DestroyCommandList-Funktion implementieren, die eine switch-Anweisung enthält, um die Zerstörung von Befehlslisten und die einfache Zerstörung von Befehlslisten zu verarbeiten. Das heißt, der Treiber kann eine DestroyCommandList implementieren und das pfnRecycleDestroyCommandList-Element der D3D11DDI_DEVICEFUNCS-Struktur so festlegen, dass er zusammen mit dem pfnRecycleDestroyCommandList-Element von D3D11DDI_DEVICEFUNCS auf DestroyCommandList verweist. Zur Verbesserung der Leistung kann der Treiber jedoch separate DestroyCommandList - und RecycleDestroyCommandList-Funktionen implementieren.

Weitere Informationen zu RecycleDestroyCommandList finden Sie unter Optimization for Small Command Listen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	DestroyCommandList wird ab dem Windows 7-Betriebssystem unterstützt.
Zielplattform	Desktop
Kopfzeile	d3d10umddi.h (include D3d10umddi.h)