Metodo ID3D12Device::CreateCommandAllocator (d3d12.h)

Crea un oggetto allocatore del comando.

Sintassi

HRESULT CreateCommandAllocator(
  [in]  D3D12_COMMAND_LIST_TYPE type,
        REFIID                  riid,
  [out] void                    **ppCommandAllocator
);

Parametri

[in] type

Tipo: D3D12_COMMAND_LIST_TYPE

Valore tipizzato D3D12_COMMAND_LIST_TYPE che specifica il tipo di allocatore di comando da creare. Il tipo di allocatore dei comandi può essere il tipo che registra elenchi di comandi diretti o bundle.

riid

Tipo: REFIID

Identificatore univoco globale (GUID) per l'interfaccia dell'allocatore del comando (ID3D12CommandAllocator). È possibile ottenere il REFIID o IL GUID dell'interfaccia all'allocatore di comando usando la macro __uuidof(). Ad esempio, __uuidof(ID3D12CommandAllocator) otterrà il GUID dell'interfaccia a un allocatore di comandi.

[out] ppCommandAllocator

Tipo: void**

Puntatore a un blocco di memoria che riceve un puntatore all'interfaccia ID3D12CommandAllocator per l'allocatore di comando.

Valore restituito

Tipo: HRESULT

Questo metodo restituisce E_OUTOFMEMORY se la memoria non è sufficiente per creare l'allocatore del comando. Per altri possibili valori restituiti, vedere Codici restituiti Direct3D 12 .

Commenti

Il dispositivo crea elenchi di comandi dall'allocatore dei comandi.

Esempio

L'esempio D3D12Bundles usa ID3D12Device::CreateCommandAllocator come segue:

ThrowIfFailed(pDevice->CreateCommandAllocator(D3D12_COMMAND_LIST_TYPE_DIRECT, IID_PPV_ARGS(&m_commandAllocator)));
ThrowIfFailed(pDevice->CreateCommandAllocator(D3D12_COMMAND_LIST_TYPE_BUNDLE, IID_PPV_ARGS(&m_bundleAllocator)));

Fare riferimento al codice di esempio nel riferimento D3D12.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	d3d12.h
Libreria	D3D12.lib
DLL	D3D12.dll

Vedi anche

ID3D12Device