ID3D12Device9 ::CreateCommandQueue1, méthode (d3d12.h)

Crée une file d’attente de commandes avec un ID de créateur.

Consultez également ID3D12Device ::CreateCommandQueue.

Syntaxe

HRESULT CreateCommandQueue1(
  const D3D12_COMMAND_QUEUE_DESC *pDesc,
  REFIID                         CreatorID,
  REFIID                         riid,
  void                           **ppCommandQueue
);

Paramètres

pDesc

Type : _In_ const D3D12_COMMAND_QUEUE_DESC*

Spécifie une D3D12_COMMAND_QUEUE_DESC qui décrit la file d’attente de commandes.

CreatorID

Type : REFIID

ID de créateur. Consultez Remarques.

riid

Type : REFIID

Identificateur global unique (GUID) de l’interface de file d’attente de commandes.

ppCommandQueue

Type : _COM_Outptr_ void**

Pointeur vers un bloc de mémoire qui reçoit un pointeur vers l’interface ID3D12CommandQueue pour la file d’attente de commandes.

Valeur retournée

Type : HRESULT

Retourne E_OUTOFMEMORY si la mémoire est insuffisante pour créer la file d’attente de commandes ; sinon , S_OK. Pour obtenir d’autres valeurs de retour possibles, consultez Codes de retour Direct3D 12 .

Remarques

Lorsque plusieurs composants du même processus partagent un seul appareil Direct3D 12, ils se retrouvent souvent avec des charges de travail distinctes sur des files d’attente de commandes indépendantes. Dans certaines implémentations matérielles, les files d’attente indépendantes peuvent s’exécuter en parallèle uniquement avec d’autres files d’attente de commandes spécifiques.

Direct3D 12 applique un regroupement de premier arrivé et premier service pour les files d’attente, qui peut ne pas fonctionner correctement pour toutes les conceptions d’applications ou de composants. Pour aider à informer le regroupement de files d’attente de Direct3D 12, vous pouvez spécifier un ID de créateur (qui est unique par composant) qui limite le regroupement à d’autres files d’attente avec le même ID. Lorsque cela est possible, un composant doit choisir le même ID unique pour toutes ses files d’attente. Microsoft a réservé quelques ID de créateur bien connus pour les implémentations d’API développées par Microsoft en plus de Direct3D 12.

Configuration requise

Voir aussi

• ID3D12Device ::CreateCommandQueue