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를 지정합니다.

앱은 일반적으로 pSO1이 개체의 이름인 매크로 IID_PPV_ARGS(&PSO1)를 사용하여 이 인수와 ppPipelineState 인수를 설정해야 합니다.

[out] ppPipelineState

형식: void**

SAL: COM_Outptr

함수가 성공적으로 반환된 후 PSO를 참조할 포인터를 지정합니다.

반환 값

형식: HRESULT

이 메서드는 이름이 없거나 스트림 설명이 라이브러리의 데이터와 일치하지 않는 경우 E_INVALIDARG 포함할 수 있는 HRESULT 성공 또는 오류 코드를 반환하고, 함수가 결과 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
라이브러리	D3d12.lib
DLL	D3d12.dll

추가 정보

스트리밍 파이프라인 desc의 레이아웃 및 동작에 대한 설명은 D3D12_PIPELINE_STATE_STREAM_DESC 참조하세요.

ID3D12PipelineLibrary1