Compartilhar via


Método ID3D12PipelineLibrary1::LoadPipeline (d3d12.h)

Recupera o PSO solicitado da biblioteca. A descrição do fluxo de pipeline é correspondida ao banco de dados de biblioteca e lembrada para evitar a duplicação de conteúdo PSO.

Sintaxe

HRESULT LoadPipeline(
  [in]  LPCWSTR                                pName,
  [in]  const D3D12_PIPELINE_STATE_STREAM_DESC *pDesc,
        REFIID                                 riid,
  [out] void                                   **ppPipelineState
);

Parâmetros

[in] pName

Tipo: LPCWSTR

SAL: In

O nome exclusivo do PSO.

[in] pDesc

Tipo: const D3D12_PIPELINE_STATE_STREAM_DESC*

SAL: In

Descreve o PSO necessário usando uma estrutura D3D12_PIPELINE_STATE_STREAM_DESC . Essa descrição corresponde ao banco de dados de biblioteca e é armazenada para evitar a duplicação de conteúdo PSO.

riid

Tipo: REFIID

Especifica um REFIID para o objeto ID3D12PipelineState .

Seu aplicativo normalmente deve definir esse argumento e o seguinte argumento, ppPipelineState, usando a macro IID_PPV_ARGS(&PSO1), em que PSO1 é o nome do objeto.

[out] ppPipelineState

Tipo: void**

SAL: COM_Outptr

Especifica o ponteiro que fará referência ao PSO depois que a função retornar com êxito.

Retornar valor

Tipo: HRESULT

Esse método retorna um código de erro ou êxito HRESULT, que pode incluir E_INVALIDARG se o nome não existir ou se a descrição do fluxo não corresponder aos dados na biblioteca e E_OUTOFMEMORY se a função não puder alocar o PSO resultante.

Comentários

Essa função usa a descrição do pipeline como um D3D12_PIPELINE_STATE_STREAM_DESC e é uma substituição para as funções ID3D12PipelineLibrary::LoadGraphicsPipeline e ID3D12PipelineLibrary::LoadComputePipeline , que assumem a descrição do pipeline como os structs D3D12_GRAPHICS_PIPELINE_STATE_DESC e D3D12_COMPUTE_PIPELINE_STATE_DESC menos flexíveis, respectivamente.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho d3d12.h
Biblioteca D3d12.lib
DLL D3d12.dll

Confira também

Consulte D3D12_PIPELINE_STATE_STREAM_DESC para obter uma descrição do layout e do comportamento de um desc de pipeline de streaming.

ID3D12PipelineLibrary1