PFND3D11DDI_DESTROYCOMMANDLIST Rückruffunktion (d3d10umddi.h)
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 zu den privaten Daten des Treibers, damit die Befehlsliste zerstört werden kann. Die Microsoft Direct3D-Laufzeit gibt den Speicherbereich frei, den sie zuvor für die Befehlsliste zugewiesen hat. Daher kann der Treiber nicht mehr auf diesen Speicherbereich zugreifen.
Rückgabewert
Nichts
Bemerkungen
Der Treiber kann die pfnSetErrorCb Rückruffunktion verwenden, um einen Fehlercode festzulegen.
Der Treiber ist nur erforderlich, um DestroyCommandList- zu 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.
Der Treiber sollte keinen Fehler haben, mit Ausnahme von D3DDDIERR_DEVICEREMOVED. Wenn der Treiber daher einen Fehler außer D3DDDIERR_DEVICEREMOVED übergibt, bestimmt die Direct3D-Laufzeit in einem Aufruf der pfnSetErrorCb--Funktion, dass der Fehler kritisch ist. Auch wenn das Gerät entfernt wird, ist der Treiber nicht erforderlich, um D3DDDIERR_DEVICEREMOVED zurückzugeben; Wenn die Geräteentfernung jedoch den Betrieb 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 ein DestroyCommandList-implementieren und das pfnRecycleDestroyCommandList Member der D3D11DDI_DEVICEFUNCS-Struktur festlegen, um auf DestroyCommandList zusammen mit dem pfnRecycleDestroyCommandList Member von D3D11DDI_DEVICEFUNCS auf DestroyCommandListverweisen. Um die Leistung zu verbessern, kann der Treiber jedoch separate DestroyCommandList- und RecycleDestroyCommandList- funktionen implementieren.
Weitere Informationen zu RecycleDestroyCommandListfinden Sie unter Optimierung für kleine Befehlslisten.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | DestroyCommandList wird ab dem Windows 7-Betriebssystem unterstützt. |
| Zielplattform- | Desktop |
| Header- | d3d10umddi.h (include D3d10umddi.h) |