DXGKDDI_VIDPN_GETTOPOLOGY funzione di callback (d3dkmddi.h)
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 di un oggetto VidPN. Il manager VidPN ha precedentemente fornito questo handle al driver miniport di visualizzazione chiamando DxgkDdiEnumVidPnCofuncModality, DxgkDdiIsSupportedVidPno 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 | La funzione ha avuto esito positivo. |
| STATUS_GRAPHICS_INVALID_VIDPN | L'handle fornito in hVidPn non è valido. |
Osservazioni
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.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows Vista |
| piattaforma di destinazione | Desktop |
| intestazione | d3dkmddi.h (include D3dkmddi.h) |
| IRQL | PASSIVE_LEVEL |