PFND3D11DDI_CREATECOMMANDLIST Rückruffunktion (d3d10umddi.h)

Artikel
02/22/2024

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)