PFND3D11DDI_CREATECOMMANDLIST fonction de rappel (d3d10umddi.h)

Article
02/22/2024

La fonction CreateCommandList crée une liste de commandes.

Syntaxe

PFND3D11DDI_CREATECOMMANDLIST Pfnd3d11ddiCreatecommandlist;

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

Paramètres

unnamedParam1

hDevice [in]

Handle pour le périphérique d’affichage (contexte graphique).

unnamedParam2

pCreateCommandList [in]

Pointeur vers une structure de D3D11DDIARG_CREATECOMMANDLIST qui décrit les paramètres que le pilote d’affichage en mode utilisateur utilise pour créer une liste de commandes.

unnamedParam3

hCommandList [in]

Handle pour les données privées du pilote pour la liste de commandes.

unnamedParam4

hRTCommandList [in]

Handle de la liste de commandes que le pilote doit utiliser lorsqu’il rappelle le runtime Direct3D.

Valeur de retour

None

Remarques

Le pilote peut utiliser la fonction de rappel pfnSetErrorCb pour définir un code d’erreur.

Le pilote n’est nécessaire pour implémenter CreateCommandList que s’il prend en charge la fonctionnalité D3D11DDICAPS_COMMANDLISTS_BUILD_2 qui peut être retournée dans la structure D3D11DDI_THREADING_CAPS à partir d’un appel à la fonction GetCaps(D3D10_2).

Le pilote peut passer E_OUTOFMEMORY (si le pilote manque de mémoire) ou D3DDDIERR_DEVICEREMOVED (si le périphérique est supprimé) dans un appel à la fonction pfnSetErrorCb . Le runtime Direct3D détermine que toutes les autres erreurs sont critiques. Si le pilote transmet des erreurs, notamment D3DDDIERR_DEVICEREMOVED, le runtime Direct3D détermine que le handle n’est pas valide ; Par conséquent, le runtime n’appelle pas la fonction DestroyCommandList pour détruire le handle spécifié par le paramètre hCommandList .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	CreateCommandList est pris en charge à partir du système d’exploitation Windows 7.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	d3d10umddi.h (incluez D3d10umddi.h)