DXGKDDI_RECOMMENDFUNCTIONALVIDPN funzione di callback (d3dkmddi.h)

Articolo
02/06/2025

La funzione DxgkDdiRecommendFunctionalVidPn crea un VidPN funzionale che può essere implementato in una scheda di visualizzazione specificata.

Sintassi

DXGKDDI_RECOMMENDFUNCTIONALVIDPN DxgkddiRecommendfunctionalvidpn;

NTSTATUS DxgkddiRecommendfunctionalvidpn(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARG_RECOMMENDFUNCTIONALVIDPN_CONST pRecommendFunctionalVidPn
)
{...}

Parametri

[in] hAdapter

Handle per un blocco di contesto associato a una scheda di visualizzazione. Il driver miniport di visualizzazione precedentemente fornito questo handle al sottosistema kernel della grafica DirectX nel MiniportDeviceContext parametro di output della funzione DxgkDdiAddDevice.

[in] pRecommendFunctionalVidPn

Puntatore a una struttura DXGKARG_RECOMMENDFUNCTIONALVIDPN che contiene argomenti di funzione. Il chiamante fornisce il membro hRecommendedFunctionalVidPn, che è un handle per un oggetto VidPN vuoto. DxgkDdiRecommendFunctionalVidPn popola l'oggetto VidPN con gli elementi di un VidPN funzionale: topologia, set di modalità, modalità aggiunte.

Valore restituito

DxgkDdiRecommendFunctionalVidPn restituisce uno dei valori seguenti:

Codice restituito	Descrizione
STATUS_SUCCESS	La funzione ha avuto esito positivo nella creazione di un VidPN funzionale.
STATUS_GRAPHICS_NO_RECOMMENDED_FUNCTIONAL_VIDPN	La funzione non è stata in grado di creare un VidPN funzionale.
STATUS_NO_MEMORY	La funzione non è riuscita perché non è stato possibile allocare memoria.

Osservazioni

Un VidPN è funzionale se soddisfa le condizioni seguenti:

Ha una topologia con almeno un percorso. Un percorso è un'associazione tra un'origine e una destinazione.
Ogni origine e destinazione nella topologia ha una modalità bloccata.

Il processo di DxgkDdiRecommendFunctionalVidPn consiste nel creare un VidPN funzionale che può essere implementato nella scheda di visualizzazione. L'elenco seguente illustra i passaggi usati per creare un VidPN funzionale.

Iniziare con un handle per un oggetto VidPN vuoto. Questo handle è stato fornito nel membro hDesiredVidPn di pRecommendFunctionalVidPnArg.
Aggiungere un percorso (coppia di destinazione di origine) alla topologia di VidPN.
Creare un nuovo set di modalità di origine e aggiungere una modalità di origine al set. Assegnare la modalità di origine impostata all'origine nel percorso. Aggiungere la modalità di origine.
Creare un nuovo set di modalità di destinazione e aggiungere una modalità di destinazione al set. Assegnare la modalità di destinazione impostata alla destinazione nel percorso. Aggiungere la modalità di destinazione.

Per informazioni su come aggiungere percorsi, aggiungere set di modalità, assegnare modalità e modalità pin, vedere Oggetti e interfacce VidPN.

dxgkDdiRecommendFunctionalVidPn deve essere reso impaginabile.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Vista
piattaforma di destinazione	Desktop
intestazione	d3dkmddi.h
IRQL	PASSIVE_LEVEL

Condividi tramite