PFND3D11DDI_CREATECOMMANDLIST Rückruffunktion (d3d10umddi.h)
Die CreateCommandList-Funktion erstellt eine Befehlsliste.
Syntax
PFND3D11DDI_CREATECOMMANDLIST Pfnd3d11ddiCreatecommandlist;
void Pfnd3d11ddiCreatecommandlist(
D3D10DDI_HDEVICE unnamedParam1,
const D3D11DDIARG_CREATECOMMANDLIST *unnamedParam2,
D3D11DDI_HCOMMANDLIST unnamedParam3,
D3D11DDI_HRTCOMMANDLIST unnamedParam4
)
{...}
Parameter
unnamedParam1
hDevice [in]
Ein Handle für das Anzeigegerät (Grafikkontext).
unnamedParam2
pCreateCommandList [in]
Ein Zeiger auf eine D3D11DDIARG_CREATECOMMANDLIST-Struktur , die die Parameter beschreibt, die der Benutzermodusanzeigetreiber zum Erstellen einer Befehlsliste verwendet.
unnamedParam3
hCommandList [in]
Ein Handle für die privaten Daten des Treibers für die Befehlsliste.
unnamedParam4
hRTCommandList [in]
Ein Handle für die Befehlsliste, das der Treiber verwenden sollte, wenn er wieder in die Direct3D-Runtime aufruft.
Rückgabewert
Keine
Bemerkungen
Der Treiber kann die Rückruffunktion pfnSetErrorCb verwenden, um einen Fehlercode festzulegen.
Der Treiber muss CreateCommandList 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.
Der Treiber kann E_OUTOFMEMORY (wenn der Treiber nicht genügend Arbeitsspeicher hat) oder D3DDDIERR_DEVICEREMOVED (wenn das Gerät entfernt wird) in einem Aufruf der pfnSetErrorCb-Funktion übergeben. Die Direct3D-Runtime bestimmt, dass alle anderen Fehler kritisch sind. Wenn der Treiber Fehler übergibt, einschließlich D3DDDIERR_DEVICEREMOVED, ermittelt die Direct3D-Runtime, dass das Handle ungültig ist. Daher ruft die Runtime die DestroyCommandList-Funktion nicht auf, um das Handle zu zerstören, das der hCommandList-Parameter angibt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | CreateCommandList wird ab dem Windows 7-Betriebssystem unterstützt. |
| Zielplattform | Desktop |
| Kopfzeile | d3d10umddi.h (include D3d10umddi.h) |