Skip to main content
Cria um objeto de estado de pipeline de gráficos derivado de outro objeto de estado de pipeline (PSO).

Sintaxe

Parâmetros

pSrcPipelineState _In_
Tipo: ID3D12PipelineState*
O estado do pipeline de origem como um ponteiro para ID3D12PipelineState. NumDescs _In_
Tipo: UINT
O número de estruturas D3D12XBOX_DERIVED_GRAPHICS_STATE_DESC em pDescs. pDescs _In_
Tipo: D3D12XBOX_DERIVED_GRAPHICS_STATE_DESC*
As descrições como uma matriz de estruturas D3D12XBOX_DERIVED_GRAPHICS_STATE_DESC. riid _In_
Tipo: REFIID
O GUID (identificador global exclusivo) da interface de estado do pipeline, ID3D12PipelineState. Para recuperar o REFIID (ou GUID) da interface para o estado do pipeline, use a macro __uuidof(). Por exemplo, para obter o GUID da interface para uma lista de comandos, faça o seguinte:
ppDerivedPipelineState _Outptr_
Tipo: void**
O objeto de estado de pipeline de gráficos derivado resultante.

Valor retornado

Tipo: HRESULT Um dos códigos de retorno do Direct3D 12.

Comentários

Este método permite criar um objeto de estado de pipeline de gráficos derivado de outro PSO. O novo objeto é derivado usando o estado do objeto de origem como estado base e permite alterações no estado de profundidade/estêncil, rasterizador e/ou mesclagem. O método pode ser útil quando nem todas as permutações do estado do PSO podem ser conhecidas e criadas offline usando ID3D12Device::DeserializeGraphicsPipelineStateX, pois CreateDerivedGraphicsPipelineStateX permite a criação em tempo de execução com classes de estado arbitrário. CreateDerivedGraphicsPipelineStateX é leve em termos de CPU e de memória. Agrupamentos de estado individuais (como estado de mesclagem ou de rasterizador) podem ser alterados. Qualquer estado não substituído será definido com o mesmo valor do PSO de origem. NumDescs descreve a contagem de agrupamentos de estado a serem alterados. Type identifica o tipo de cada agrupamento de estado. Veja a seguir as responsabilidades do chamador:
  • Se o PSO de origem tiver sido criado por meio de DeserializeGraphicsPipelineStateX: o chamador deve garantir que as instruções da GPU persistam durante o tempo de vida do objeto original e do objeto derivado.
  • Se o PSO de origem tiver sido criado por meio de CreateGraphicsPipelineState: para garantir que suas instruções da GPU persistam durante o tempo de vida do objeto derivado, o subsistema D3D12 adiciona automaticamente uma contagem de referência ao objeto de origem.
CreateDerivedGraphicsPipelineStateX garante que o sombreador não será recompilado nem corrigido como parte do processo de criação.

Requisitos

Cabeçalho: d3d12_x.h Biblioteca: d3d12_x.lib Plataformas com suporte: família XBOX One

Confira também

ID3D12Device
Last modified on October 6, 2026