DXGKDDI_RECOMMENDFUNCTIONALVIDPN funzione di callback (d3dkmddi.h)

  • Articolo

La funzione DxgkDdiRecommendFunctionalVidPn crea una funzione VidPN funzionale che può essere implementata 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 a un blocco di contesto associato a una scheda di visualizzazione. Il driver miniport visualizzato in precedenza ha fornito questo handle al sottosistema kernel di grafica DirectX nel parametro di output MiniportDeviceContext 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 una vidPN funzionale: topologia, set di modalità, modalità aggiunta.

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 in grado di allocare memoria.

Commenti

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à aggiunta.
Il processo di DxgkDdiRecommendFunctionalVidPn consiste nel creare un VidPN funzionale che può essere implementato nella scheda di visualizzazione. L'elenco seguente fornisce i passaggi usati per creare un VidPN funzionale.
  1. Iniziare con un handle a un oggetto VidPN vuoto. Questo handle è stato fornito nel membro hDesiredVidPn di pRecommendFunctionalVidPnArg.
  2. Aggiungere un percorso (coppia di destinazione di origine) alla topologia di VidPN.
  3. Creare un nuovo set di modalità di origine e aggiungere una modalità di origine al set. Assegnare la modalità di origine impostata sull'origine nel percorso. Aggiungere la modalità di origine.
  4. Creare un nuovo set di modalità di destinazione e aggiungere una modalità di destinazione al set. Assegnare la modalità di destinazione impostata sulla destinazione nel percorso. Aggiungere la modalità di destinazione.
Per informazioni su come aggiungere percorsi, aggiungere set di modalità, assegnare modalità e pin, vedere Oggetti e interfacce VidPN.

DxgkDdiRecommendFunctionalVidPn deve essere reso paginabile.

Requisiti

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