共用方式為

ID3D12Device：：CreateCommandAllocator 方法 (d3d12.h)

  • 發行項

建立命令配置器物件。

語法

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

參數

[in] type

類型： D3D12_COMMAND_LIST_TYPE

D3D12_COMMAND_LIST_TYPE型別值，指定要建立的命令配置器類型。 命令配置器的類型可以是記錄直接命令清單或配套的類型。

riid

類型： REFIID

命令配置器介面的全域唯一標識碼 (GUID) (ID3D12CommandAllocator) 。 您可以使用 __uuidof () 宏來取得命令配置器的介面 REFIID 或 GUID。 例如，__uuidof (ID3D12CommandAllocator) 會取得介面的 GUID 給命令配置器。

[out] ppCommandAllocator

類型： void**

記憶體區塊的指標，接收命令配置器的 ID3D12CommandAllocator 介面指標。

傳回值

類型： HRESULT

如果記憶體不足而無法建立命令配置器，這個方法會傳回 E_OUTOFMEMORY 。 如需其他可能的傳回值，請參閱 Direct3D 12 傳回碼 。

備註

裝置會從命令配置器建立命令清單。

範例

D3D12Bundles 範例使用 ID3D12Device：：CreateCommandAllocator，如下所示：

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)));

請參閱 D3D12 參考中的範例程式代碼。

規格需求

需求 值
目標平台 Windows
標頭 d3d12.h
程式庫 D3D12.lib
Dll D3D12.dll

另請參閱

ID3D12Device