Oggetti e interfacce VidPN

Il gestore della rete video (VidPN) utilizza un oggetto VidPN per mantenere le informazioni sulle associazioni tra le sorgenti video presenti, le destinazioni video presenti e le modalità di visualizzazione. Per altre informazioni, vedere l'argomento Introduzione alle reti di presentazione video .

Oggetto VidPN

Un oggetto VidPN contiene gli oggetti secondari seguenti.

• Topologia

• Set di modalità di origine

• Set di modalità di destinazione

• Monitorare l'impostazione della modalità della sorgente

• Imposta l'intervallo di frequenza del monitor

• Monitorare il set di descrittori

• Percorso

• Fonte

• Obiettivo

• Modalità di origine

• Modalità di destinazione

• Monitorare la modalità di origine

Il diagramma seguente illustra un oggetto VidPN e i relativi oggetti secondari.

Il diagramma precedente illustra se una particolare associazione è uno-a-uno, uno-a-molti, molti-a-uno o molti-a-molti. Ad esempio, il diagramma mostra che un'origine può appartenere a più percorsi, ma una destinazione può appartenere a un solo percorso.

Gli oggetti blu nel diagramma sono accessibili tramite handle e interfacce e gli oggetti grigi sono accessibili tramite puntatori di struttura. Un'interfaccia in questo contesto è una struttura che contiene puntatori a funzione. Ad esempio, la struttura DXGK_VIDPNTOPOLOGY_INTERFACE contiene puntatori alle funzioni (implementate dal gestore VidPN) chiamate dal driver miniport di visualizzazione per esaminare e modificare un oggetto topologia. Quando il driver miniport di visualizzazione chiama una di queste funzioni, deve fornire un handle a un oggetto topologico. Nella tabella seguente sono elencati i tipi di dati handle, interface e puntatore usati per accedere a un oggetto VidPN e ai relativi oggetti secondari.

Gestione VidPN

Il gestore VidPN, uno dei componenti del sottosistema kernel della grafica DirectX, collabora con il driver miniport di visualizzazione per compilare e gestire i VidPN. I passaggi seguenti descrivono come il driver miniport di visualizzazione ottiene un handle e un'interfaccia per un oggetto VidPN.

1. Durante l'inizializzazione, il sottosistema kernel della grafica DirectX chiama la funzione DxgkDdiStartDevice del driver miniport di visualizzazione. Tale chiamata fornisce al driver miniport di visualizzazione una struttura DXGKRNL_INTERFACE, che contiene puntatori alle funzioni implementate dal sottosistema kernel grafico DirectX. Una di queste funzioni è DxgkCbQueryVidPnInterface.

2. A un certo punto, il responsabile VidPN necessita di aiuto dal driver miniport di visualizzazione, quindi fornisce al driver miniport di visualizzazione un handle per un oggetto VidPN chiamando una delle funzioni seguenti:

   • DxgkDdiIsSupportedVidPn
   • DxgkDdiRecommendFunctionalVidPn
   • DxgkDdiEnumVidPnCofuncModality

3. Il driver miniport di visualizzazione passa l'handle ottenuto nel passaggio 2 a DxgkCbQueryVidPnInterface, che restituisce un puntatore a una struttura DXGK_VIDPN_INTERFACE.

Dopo che il driver miniport di visualizzazione ha un handle e un'interfaccia per un oggetto VidPN, può ottenere handle e interfacce (se necessario) per i sotto-oggetti principali: topologia, set di modalità di origine, set di modalità di destinazione e set di modalità di origine del monitor. Ad esempio, il driver miniport di visualizzazione può chiamare pfnGetTopology (una delle funzioni dell'interfaccia VidPN) per ottenere un handle a un oggetto di topologia VidPN e un puntatore a una struttura DXGK_VIDPNTOPOLOGY_INTERFACE.

Le funzioni seguenti (nell'interfaccia VidPN) forniscono handle e interfacce agli oggetti secondari primari di un oggetto VidPN.

• pfnGetTopology
• pfnAcquireSourceModeSet
• pfnAcquireTargetModeSet

Si noti che due delle funzioni nell'elenco precedente hanno funzioni corrispondenti che rilasciano oggetti secondari VidPN.

• pfnReleaseSourceModeSet

• pfnReleaseTargetModeSet

Dopo che il driver di miniport di visualizzazione ottiene un handle e un'interfaccia a uno degli oggetti secondari principali di un VidPN, può chiamare le funzioni di interfaccia per ottenere i descrittori di oggetti correlati all'oggetto secondario principale. Ad esempio, dati un handle e un'interfaccia per un oggetto di topologia, il driver miniport di visualizzazione potrebbe eseguire i passaggi seguenti per ottenere i descrittori di tutti i percorsi nella topologia.

1. Interfaccia della topologia VidPN

   Chiamare la funzione pfnAcquireFirstPathInfo dell'interfaccia della topologia VidPN per ottenere un puntatore a una struttura D3DKMDT_VIDPN_PRESENT_PATH che descrive il primo percorso nella topologia.

2. Interfaccia della topologia VidPN

   Chiamare ripetutamente la funzione pfnAcquireNextPathInfo per ottenere puntatori alle strutture D3DKMDT_VIDPN_PRESENT_PATH che descrivono i percorsi rimanenti nella topologia.

Analogamente, il driver miniport di visualizzazione può ottenere descrittori delle modalità in un set di modalità chiamando le funzioni pfnAcquireFirstModeInfo e pfnAcquireNextModeInfo di una delle interfacce set di modalità seguenti.

• DXGK_VIDPNSOURCEMODESET_INTERFACE

• DXGK_VIDPNTARGETMODESET_INTERFACE

• DXGK_MONITORSOURCEMODESET_INTERFACE

Si noti che l'interfaccia DXGK_VIDPNSOURCEMODESET_INTERFACE non ha alcuna funzione per rimuovere una modalità da un set di modalità di origine. Quando il driver miniport di visualizzazione deve aggiornare un set di modalità di origine, non modifica una modalità esistente impostata aggiungendo e rimuovendo le modalità. Crea invece un nuovo set di modalità che sostituisce il set di modalità precedente. Un esempio di funzione che deve aggiornare i set di modalità è la funzione DxgkDdiEnumVidPnCofuncModality del driver di miniport. I passaggi necessari per aggiornare un set di modalità di origine sono i seguenti:

1. Chiamare pfnCreateNewModeInfo dell'interfaccia DXGK_VIDPNSOURCEMODESET_INTERFACE per ottenere un puntatore a una struttura D3DKMDT_VIDPN_SOURCE_MODE (allocata dal gestore VidPN).

   Chiamare ripetutamente pfnAddMode per aggiungere le modalità al set di modalità di origine.

2. Chiamare la funzione pfnAssignSourceModeSet del DXGK_VIDPN_INTERFACE per assegnare la nuova modalità impostata su una determinata origine video presente. Il nuovo set di modalità di origine sostituisce il set di modalità di origine attualmente assegnato a tale origine.

L'aggiornamento di un set di modalità di destinazione è simile all'aggiornamento di un set di modalità di origine. L'interfaccia DXGK_VIDPNTARGETMODESET_INTERFACE ha le funzioni seguenti:

• Impostazione modalità di destinazione dell'interfaccia VidPN

  Funzione pfnCreateNewModeInfo per la creazione di un nuovo set di modalità di destinazione e una funzione pfnAddMode per l'aggiunta di modalità al set.

Non esiste un'interfaccia (set di funzioni) per ottenere l'origine e la destinazione che appartengono a un determinato percorso. Il driver miniport di visualizzazione può determinare quale origine e destinazione appartiene a un determinato percorso esaminando i membri VidPnSourceId e VidPnTargetId della struttura D3DKMDT_VIDPN_PRESENT_PATH che rappresenta il percorso.

Vedere anche

Determinare se un vidPN è supportato in una scheda di visualizzazione

Enumerazione delle modalità di origine e di destinazione co-funzionale VidPN

Terminologia attuale della rete video

Recupero di modalità di destinazione di monitoraggio aggiuntive