ID3D12PipelineLibrary1 ::LoadPipeline, méthode (d3d12.h)

Article
02/26/2024

Récupère l’authentification unique demandée à partir de la bibliothèque. La description du flux de pipeline est mise en correspondance avec la base de données de la bibliothèque et mémorisée afin d’éviter la duplication du contenu de l’authentification unique.

Syntaxe

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

Paramètres

[in] pName

Type : LPCWSTR

SAL : In

Nom unique de l’authentification unique.

[in] pDesc

Type : const D3D12_PIPELINE_STATE_STREAM_DESC*

SAL : In

Décrit l’authentification unique requise à l’aide d’une structure D3D12_PIPELINE_STATE_STREAM_DESC . Cette description est mise en correspondance avec la base de données de la bibliothèque et stockée afin d’éviter la duplication du contenu de l’authentification unique.

riid

Type : REFIID

Spécifie un REFIID pour l’objet ID3D12PipelineState .

Votre application doit généralement définir cet argument et l’argument suivant, ppPipelineState, à l’aide de la macro IID_PPV_ARGS(&PSO1), où PSO1 est le nom de l’objet.

[out] ppPipelineState

Type : void**

SAL : COM_Outptr

Spécifie le pointeur qui référencera l’authentification unique après le retour de la fonction.

Valeur retournée

Type : HRESULT

Cette méthode retourne un code de réussite ou d’erreur HRESULT, qui peut inclure E_INVALIDARG si le nom n’existe pas ou si la description du flux ne correspond pas aux données de la bibliothèque, et E_OUTOFMEMORY si la fonction ne parvient pas à allouer l’authentification unique résultante.

Remarques

Cette fonction prend la description du pipeline en tant que D3D12_PIPELINE_STATE_STREAM_DESC et remplace les fonctions ID3D12PipelineLibrary ::LoadGraphicsPipeline et ID3D12PipelineLibrary ::LoadComputePipeline , qui prennent respectivement leur description de pipeline en tant que structs D3D12_GRAPHICS_PIPELINE_STATE_DESC et D3D12_COMPUTE_PIPELINE_STATE_DESC moins flexibles.

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	d3d12.h
Bibliothèque	D3d12.lib
DLL	D3d12.dll

Voir aussi

Consultez D3D12_PIPELINE_STATE_STREAM_DESC pour obtenir une description de la disposition et du comportement d’un desc de pipeline de streaming.

ID3D12PipelineLibrary1

Partager via