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
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 10 Build 20348 |
| Serveur minimal pris en charge | Windows 10 Build 20348 |
| En-tête | d3d12.h |
| Bibliothèque | d3d12.lib |
| DLL | d3d12.dll |