Oggetti e interfacce VidPN

Il responsabile della rete (VidPN) presenta video usa un oggetto VidPN per mantenere le informazioni sulle associazioni tra origini video presenti, destinazioni presenti video e modalità di visualizzazione. Per altre informazioni, vedere l'argomento Introduzione a Video Present Networks .

Oggetto VidPN

Un oggetto VidPN contiene gli oggetti secondari seguenti.

• Topologia

• Set di modalità di origine

• Set di modalità di destinazione

• Monitorare il set di modalità di origine

• Monitoraggio del set di intervalli di frequenza

• Monitorare il set di descrittori

• Percorso

• Source (Sorgente)

• Destinazione

• Modalità 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 vengono accessibili tramite handle e interfacce e gli oggetti grigi vengono accessibili tramite puntatori struttura. Un'interfaccia in questo contesto è una struttura che contiene puntatori a funzioni. Ad esempio, la struttura DXGK_VIDPNTOPOLOGY_INTERFACE contiene puntatori alle funzioni (implementate dal gestore VidPN) che il driver miniport visualizzato chiama per controllare e modificare un oggetto topologia. Quando il driver miniport visualizzato chiama una di queste funzioni, deve fornire un handle a un oggetto topologia. Nella tabella seguente sono elencati i tipi di dati handle, interfaccia 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 visualizzato per compilare e gestire VidPNs. I passaggi seguenti descrivono come il driver miniport visualizzato ottiene un handle e un'interfaccia per un oggetto VidPN.

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

2. A un certo punto, il gestore VidPN richiede assistenza dal driver miniport visualizzato, quindi fornisce al driver miniport visualizzato un handle per un oggetto VidPN chiamando una delle funzioni seguenti:

   • DxgkDdiIsSupportedVidPn
   • DxgkDdiRecommendFunctionalVidPn
   • DxgkDdiEnumVidPnCofuncModality

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

Dopo che il driver miniport visualizzato ha un handle e un'interfaccia per un oggetto VidPN, può ottenere handle e interfacce (in base alle esigenze) agli oggetti secondari primari: topologia, set di modalità di origine, set di modalità di destinazione e monitoraggio del set di modalità di origine. Ad esempio, il driver miniport visualizzato può chiamare pfnGetTo topologia (una delle funzioni nell'interfaccia VidPN) per ottenere un handle in un oggetto 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 miniport visualizzato ottiene un handle e un'interfaccia a uno degli oggetti secondari primari VidPNs, può chiamare le funzioni di interfaccia per ottenere descrittori di oggetti correlati all'oggetto secondario. Ad esempio, dato un handle e un'interfaccia a un oggetto topologia, il driver miniport visualizzato potrebbe eseguire i passaggi seguenti per ottenere 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 della 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 visualizzato 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 visualizzato deve aggiornare un set di modalità di origine, non modifica un set di modalità esistente 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 visualizzazione. I passaggi coinvolti nell'aggiornamento di 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 della DXGK_VIDPN_INTERFACE per assegnare la nuova modalità impostata su un'origine video specifica. 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:

• Interfaccia Set di modalità di destinazione 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 alcuna interfaccia (set di funzioni) per ottenere l'origine e la destinazione che appartengono a un determinato percorso. Il driver miniport visualizzato può determinare quale origine e destinazione appartiene a un determinato percorso controllando i membri VidPnSourceId e VidPnTargetId della struttura D3DKMDT_VIDPN_PRESENT_PATH che rappresenta il percorso.

Vedi anche

Determinare se un vidPN è supportato in una scheda di visualizzazione

Enumerazione delle modalità di origine e destinazione di Cofunctional VidPN

Video presenta terminologia di rete

Recupero di modalità di destinazione di monitoraggio aggiuntive