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.