通过

ID3D12PipelineLibrary1：：LoadPipeline 方法 (d3d12.h)

  • 项目

从库检索请求的 PSO。 管道流说明与库数据库匹配并记住，以防止 PSO 内容重复。

语法

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

参数

[in] pName

类型： LPCWSTR

SAL： In

PSO 的唯一名称。

[in] pDesc

类型： const D3D12_PIPELINE_STATE_STREAM_DESC*

SAL： In

使用 D3D12_PIPELINE_STATE_STREAM_DESC 结构描述所需的 PSO。 此说明与库数据库匹配并存储，以防止 PSO 内容重复。

riid

类型： REFIID

为 ID3D12PipelineState 对象指定 REFIID。

应用通常应通过使用宏IID_PPV_ARGS (&PSO1) 设置此参数和以下参数 ppPipelineState，其中 PSO1 是对象的名称。

[out] ppPipelineState

类型： void**

SAL： COM_Outptr

指定在函数成功返回后将引用 PSO 的指针。

返回值

类型： HRESULT

此方法返回 HRESULT 成功代码或错误代码，如果名称不存在或流说明与库中的数据不匹配，则可以包含E_INVALIDARG，如果函数无法分配生成的 PSO，则E_OUTOFMEMORY。

注解

此函数采用管道说明作为 D3D12_PIPELINE_STATE_STREAM_DESC ，并取代 ID3D12PipelineLibrary：：LoadGraphicsPipeline 和 ID3D12PipelineLibrary：：LoadComputePipeline 函数，它们分别将其管道描述作为不太灵活的 D3D12_GRAPHICS_PIPELINE_STATE_DESC 和 D3D12_COMPUTE_PIPELINE_STATE_DESC 结构。

要求

要求 值
目标平台 Windows
标头 d3d12.h
Library D3d12.lib
DLL D3d12.dll

另请参阅

有关流式处理管道 desc 的布局和行为的说明，请参阅 D3D12_PIPELINE_STATE_STREAM_DESC 。

ID3D12PipelineLibrary1