PFND3D11DDI_CREATECOMMANDLIST funzione di callback (d3d10umddi.h)

Articolo
08/07/2023

La funzione CreateCommandList crea un elenco di comandi.

Sintassi

PFND3D11DDI_CREATECOMMANDLIST Pfnd3d11ddiCreatecommandlist;

void Pfnd3d11ddiCreatecommandlist(
  D3D10DDI_HDEVICE unnamedParam1,
  const D3D11DDIARG_CREATECOMMANDLIST *unnamedParam2,
  D3D11DDI_HCOMMANDLIST unnamedParam3,
  D3D11DDI_HRTCOMMANDLIST unnamedParam4
)
{...}

Parametri

unnamedParam1

hDevice [in]

Handle per il dispositivo di visualizzazione (contesto grafico).

unnamedParam2

pCreateCommandList [in]

Puntatore a una struttura D3D11DDIARG_CREATECOMMANDLIST che descrive i parametri usati dal driver di visualizzazione in modalità utente per creare un elenco di comandi.

unnamedParam3

hCommandList [in]

Handle per i dati privati del driver per l'elenco di comandi.

unnamedParam4

hRTCommandList [in]

Handle all'elenco di comandi che il driver deve usare, quando viene chiamato di nuovo nel runtime Direct3D.

Valore restituito

nessuno

Osservazioni

Il driver può usare la funzione di callback pfnSetErrorCb per impostare un codice di errore.

Il driver è necessario solo per implementare CreateCommandList se il driver supporta la funzionalità di D3D11DDICAPS_COMMANDLISTS_BUILD_2 che può essere restituita nella struttura D3D11DDI_THREADING_CAPS da una chiamata alla funzione GetCaps(D3D10_2).

Il driver può passare E_OUTOFMEMORY (se il driver non è in memoria) o D3DDDIERR_DEVICEREMOVED (se il dispositivo viene rimosso) in una chiamata alla funzione pfnSetErrorCb . Il runtime Direct3D determina che eventuali altri errori sono critici. Se il driver supera eventuali errori, inclusi D3DDDIERR_DEVICEREMOVED, il runtime Direct3D determina che l'handle non è valido; pertanto, il runtime non chiama la funzione DestroyCommandList per eliminare l'handle specificato dal parametro hCommandList .

Requisiti

Requisito	Valore
Client minimo supportato	CreateCommandList è supportato a partire dal sistema operativo Windows 7.
Piattaforma di destinazione	Desktop
Intestazione	d3d10umddi.h (include D3d10umddi.h)