DXGKDDI_VIDPN_GETTOPOLOGY funzione di callback (d3dkmddi.h)

Articolo
02/25/2024

La funzione pfnGetTopology restituisce un handle all'oggetto topologia VidPN contenuto in un oggetto VidPN specificato.

Sintassi

DXGKDDI_VIDPN_GETTOPOLOGY DxgkddiVidpnGettopology;

NTSTATUS DxgkddiVidpnGettopology(
  [in]  IN_CONST_D3DKMDT_HVIDPN hVidPn,
  [out] OUT_PD3DKMDT_HVIDPNTOPOLOGY phVidPnTopology,
  [out] DEREF_OUT_CONST_PPDXGK_VIDPNTOPOLOGY_INTERFACE ppVidPnTopologyInterface
)
{...}

Parametri

[in] hVidPn

Handle per un oggetto VidPN. Il manager VidPN ha precedentemente fornito questo handle al driver miniport di visualizzazione chiamando DxgkDdiEnumVidPnCofuncModality, DxgkDdiIsSupportedVidPn o DxgkDdiRecommendFunctionalVidPn.

[out] phVidPnTopology

Puntatore a una variabile che riceve un handle per l'oggetto topologia VidPN.

[out] ppVidPnTopologyInterface

Puntatore a una variabile che riceve un puntatore a una struttura DXGK_VIDPNTOPOLOGY_INTERFACE . La struttura contiene puntatori alle funzioni che il driver miniport di visualizzazione può chiamare per esaminare e modificare l'oggetto topologia VidPN.

Valore restituito

La funzione pfnGetTopology restituisce uno dei valori seguenti:

Codice restituito	Descrizione
STATUS_SUCCESS	Funzione completata.
STATUS_GRAPHICS_INVALID_VIDPN	L'handle fornito in hVidPn non è valido.

Commenti

Il driver miniport di visualizzazione non deve rilasciare l'handle ricevuto in phVidPnTopology.

La durata della struttura DXGK_VIDPNTOPOLOGY_INTERFACE restituita in ppVidPnTopologyInterface è di proprietà del sistema operativo. Usando questo schema di proprietà, il sistema operativo può eseguire la migrazione a implementazioni più recenti in fase di esecuzione senza interrompere i client dell'interfaccia.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Piattaforma di destinazione	Desktop
Intestazione	d3dkmddi.h (include D3dkmddi.h)
IRQL	PASSIVE_LEVEL

Vedi anche

DXGK_VIDPNTOPOLOGY_INTERFACE

Interfaccia della topologia VidPN

Share via