Поделиться через

Метод 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

Описывает требуемый pso с использованием структуры D3D12_PIPELINE_STATE_STREAM_DESC . Это описание сопоставляется с базой данных библиотеки и сохраняется во избежание дублирования содержимого PSO.

riid

Тип: REFIID

Указывает REFIID для объекта ID3D12PipelineState .

Как правило, приложение должно задавать этот аргумент и следующий аргумент ppPipelineState с помощью макроса IID_PPV_ARGS(&PSO1), где PSO1 — это имя объекта.

[out] ppPipelineState

Тип: void**

SAL: COM_Outptr

Указывает указатель, который будет ссылаться на PSO после успешного возврата функции.

Возвращаемое значение

Тип: HRESULT

Этот метод возвращает код успеха или ошибки HRESULT, который может включать E_INVALIDARG, если имя не существует или описание потока не соответствует данным в библиотеке, и E_OUTOFMEMORY, если функция не может выделить результирующий pso.

Комментарии

Эта функция принимает описание конвейера как D3D12_PIPELINE_STATE_STREAM_DESC и заменяет функции ID3D12PipelineLibrary::LoadGraphicsPipeline и ID3D12PipelineLibrary::LoadComputePipeline , которые принимают описание конвейера как менее гибкие D3D12_GRAPHICS_PIPELINE_STATE_DESC и D3D12_COMPUTE_PIPELINE_STATE_DESC структуры соответственно.

Требования

Требование Значение
Целевая платформа Windows
Header d3d12.h
Библиотека D3d12.lib
DLL D3d12.dll

См. также раздел

Описание макета и поведения конвейера потоковой передачи см. в D3D12_PIPELINE_STATE_STREAM_DESC .

ID3D12PipelineLibrary1