Método ID3D12Device10::CreateCommittedResource3 (d3d12.h)

Cria um recurso confirmado com um layout inicial em vez de um estado inicial.

Requer o SDK de Agilidade do DirectX 12 1.7 ou posterior.

Sintaxe

HRESULT CreateCommittedResource3(
  const D3D12_HEAP_PROPERTIES    *pHeapProperties,
  D3D12_HEAP_FLAGS               HeapFlags,
  const D3D12_RESOURCE_DESC1     *pDesc,
  D3D12_BARRIER_LAYOUT           InitialLayout,
  const D3D12_CLEAR_VALUE        *pOptimizedClearValue,
  ID3D12ProtectedResourceSession *pProtectedSession,
  UINT32                         NumCastableFormats,
  const DXGI_FORMAT              *pCastableFormats,
  REFIID                         riidResource,
  void                           **ppvResource
);

Parâmetros

pHeapProperties

Tipo: _In_ const D3D12_HEAP_PROPERTIES*

Um ponteiro para uma estrutura D3D12_HEAP_PROPERTIES que fornece propriedades para o heap do recurso.

HeapFlags

Tipo: D3D12_HEAP_FLAGS

Opções de heap, como uma combinação OR'd bit a bit de constantes de enumeração D3D12_HEAP_FLAGS.

pDesc

Tipo: const D3D12_RESOURCE_DESC1*

Um ponteiro para uma estrutura de D3D12_RESOURCE_DESC1 que descreve o recurso, incluindo uma região de mip.

InitialLayout

O layout inicial do recurso de textura; D3D12_BARRIER_LAYOUT::D 3D12_BARRIER_LAYOUT_UNDEFINED para buffers.

pOptimizedClearValue

Tipo: const D3D12_CLEAR_VALUE*

Especifica uma estrutura de D3D12_CLEAR_VALUE que descreve o valor padrão para uma cor clara.

pOptimizedClearValue especifica um valor para o qual as operações claras são mais ideais. Quando o recurso criado é uma textura com os sinalizadores D3D12_RESOURCE_FLAG_ALLOW_RENDER_TARGET ou D3D12_RESOURCE_FLAG_ALLOW_DEPTH_STENCIL, você deve escolher o valor com o qual a operação clara será mais comumente chamada. Você pode chamar a operação clara com outros valores, mas essas operações não serão tão eficientes quanto quando o valor corresponder ao passado para a criação de recursos.

Ao usar D3D12_RESOURCE_DIMENSION_BUFFER, você deve definir pOptimizedClearValue para nullptr.

pProtectedSession

Tipo: ID3D12ProtectedResourceSession*

Um ponteiro opcional para um objeto que representa uma sessão para proteção de conteúdo. Se fornecida, esta sessão indica que o recurso deve ser protegido. Você pode obter um ID3D12ProtectedResourceSession chamando ID3D12Device4::CreateProtectedResourceSession.

NumCastableFormats

O número de elementos em pCastableFormats.

pCastableFormats

Uma matriz contígua de estruturas de DXGI_FORMAT às quais esse recurso pode ser convertido.

riidResource

Tipo: REFIID

Uma referência ao identificador global exclusivo (GUID) da interface de recurso a ser retornada em ppvResource.

Embora riidResource seja mais comumente a GUID de ID3D12Resource, pode ser o GUID de qualquer interface. Se o objeto de recurso não der suporte à interface para este guid, a criação falhará com E_NOINTERFACE.

ppvResource

Tipo: void**

Um ponteiro opcional para um bloco de memória que recebe o ponteiro de interface solicitado para o objeto de recurso criado.

ppvResource pode ser nullptrpara habilitar o teste de capacidade. Quando ppvResource é nullptr, nenhum objeto é criado e S_FALSE é retornado quando pDesc é válido.

Valor de retorno

Tipo: HRESULT

Se a função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um de código de erro HRESULT.

Consulte códigos de retorno do Direct3D 12 para obter outros valores de retorno possíveis.

Requisitos

Consulte também

ID3D12Device10