VidPN – objekty a rozhraní

Správce sítě prezentujícího videa používá objekt VidPN k udržování informací o přidružení mezi zdroji prezentace videa, cíli prezentace videa a režimy zobrazení. Další informace naleznete v tématu Úvod do Video Present Networks.

Objekt VidPN

Objekt VidPN obsahuje následující dílčí objekty.

• Topologie

• Nastaven režim zdroje

• Nastavení cílového režimu

• Nastavit zdrojový režim monitoru

• Nastavení rozsahu frekvence monitorování

• Sada popisovačů monitoru

• Cesta

• Zdroj

• Cíl

• Režim zdroje

• Cílový režim

• Monitorování zdrojového režimu

Následující diagram znázorňuje objekt VidPN a jeho dílčí objekty.

Předchozí diagram znázorňuje, jestli je určité asociace jedna ku jedné, jedna ku mnoha, mnoho ku jedné, nebo mnoho ku mnoha. Diagram například ukazuje, že zdroj může patřit do více než jedné cesty, ale cíl může patřit pouze do jedné cesty.

Modré objekty v diagramu jsou přístupné prostřednictvím popisovačů a rozhraní a šedé objekty jsou přístupné prostřednictvím ukazatelů struktury. Rozhraní v tomto kontextu je struktura, která obsahuje ukazatele funkce. Například struktura DXGK_VIDPNTOPOLOGY_INTERFACE obsahuje ukazatele na funkce (implementované správcem VidPN), které ovladač miniportu volá k kontrole a změně objektu topologie. Když ovladač zobrazení miniportu volá některou z těchto funkcí, musí poskytnout popisovač objektu topologie. Následující tabulka uvádí datové typy popisovače, rozhraní a ukazatele používané pro přístup k objektu VidPN a jeho dílčím objektům.

Objekt	Metoda přístupu a datový typ
VidPN (rozhraní VidPN)	Přístup prostřednictvím popisovače a rozhraní. D3DKMDT_HVIDPN, DXGK_VIDPN_INTERFACE
Topologie (rozhraní topologie VidPN)	Přístup prostřednictvím popisovače a rozhraní. D3DKMDT_HVIDPNTOPOLOGY, DXGK_VIDPNTOPOLOGY_INTERFACE
Sada režimů zdroje (rozhraní sady režimů zdroje VidPN)	Přístup prostřednictvím popisovače a rozhraní. D3DKMDT_HVIDPNSOURCEMODESET, DXGK_VIDPNSOURCEMODESET_INTERFACE
Sada cílových režimů (rozhraní sady cílových režimů VidPN)	Přístup prostřednictvím popisovače a rozhraní. D3DKMDT_HVIDPNTARGETMODESET, DXGK_VIDPNTARGETMODESET_INTERFACE
Nastavení režimu zdroje monitoru	Přístup prostřednictvím popisovače a rozhraní. D3DKMDT_HMONITORSOURCEMODESET, DXGK_MONITORSOURCEMODESET_INTERFACE
Cesta	Přístup prostřednictvím ukazatele struktury D3DKMDT_VIDPN_PRESENT_PATH
Zdroj	Přístup prostřednictvím ukazatele struktury D3DKMDT_VIDEO_PRESENT_SOURCE
Cíl	Přístup prostřednictvím ukazatele struktury D3DKMDT_VIDEO_PRESENT_TARGET
Režim zdroje	Přístup prostřednictvím ukazatele struktury D3DKMDT_VIDPN_SOURCE_MODE
Cílový režim	Přístup prostřednictvím ukazatele struktury D3DKMDT_VIDPN_TARGET_MODE
Monitorování zdrojového režimu	Přístup prostřednictvím ukazatele struktury D3DKMDT_MONITOR_SOURCE_MODE
Nastavení rozsahu frekvence monitorování	Přístup prostřednictvím ukazatele struktury [DXGK_MONITORFREQUENCYRANGESET_INTERFACE
Sada popisovačů monitoru	Přístup prostřednictvím ukazatele struktury [DXGK_MONITORDESCRIPTORSET_INTERFACE

Správce VidPN

Správce VidPN, který je jednou z komponent grafického subsystému DirectX, spolupracuje s ovladačem miniportu displeje k sestavení a údržbě VidPNs. Následující kroky popisují, jak ovladač miniportu zobrazení získá popisovač a rozhraní VidPN objektu.

1. Během inicializace volá subsystém jádra grafiky DirectX funkci DxgkDdiStartDevice miniportového ovladače zobrazení. Toto volání poskytuje ovladač miniportu zobrazení se strukturou DXGKRNL_INTERFACE , která obsahuje ukazatele na funkce implementované subsystémem jádra grafiky DirectX. Jednou z těchto funkcí je DxgkCbQueryVidPnInterface.

2. V určitém okamžiku potřebuje správce VidPN pomoc od ovladače miniportu zobrazení, tím poskytne ovladači miniportu zobrazení popisovač objektu VidPN voláním jedné z následujících funkcí:

   • DxgkDdiIsSupportedVidPn
   • DxgkDdiRecommendFunctionalVidPn
   • DxgkDdiEnumVidPnCofuncModality

3. Ovladač miniportu zobrazení předá popisovač získaný v kroku 2 do DxgkCbQueryVidPnInterface, který vrátí ukazatel na strukturu DXGK_VIDPN_INTERFACE.

Jakmile má ovladač miniportu zobrazení popisovač a rozhraní pro objekt VidPN, může získat popisovače a rozhraní (podle potřeby) k hlavním dílčím objektům: topologii, sadě zdrojových režimů, sadě cílových režimů a sadě režimů zdroje monitoru. Například ovladač miniportu zobrazení může volat pfnGetTopology (jedna z funkcí v rozhraní VidPN), aby získal popisovač objektu topologie VidPN a ukazatel na strukturu DXGK_VIDPNTOPOLOGY_INTERFACE.

Následující funkce (v rozhraní VidPN) nabízejí popisovače a rozhraní k hlavním podobjektům objektu VidPN.

• pfnGetTopology
• pfnAcquireSourceModeSet
• pfnAcquireTargetModeSet

Všimněte si, že dvě funkce v předchozím seznamu mají odpovídající funkce, které vydávají dílčí objekty VidPN.

• pfnReleaseSourceModeSet

• pfnReleaseTargetModeSet

Jakmile ovladač miniportu zobrazení získá popisovač a rozhraní k jednomu z primárních dílčích objektů VidPNs, může volat funkce rozhraní a získat popisovače objektů, které souvisejí s tímto dílčím objektem. Například vzhledem k popisovači a rozhraní objektu topologie může ovladač miniportu zobrazení provést následující kroky k získání popisovačů všech cest v topologii.

1. Rozhraní topologie VidPN

   Zavolejte funkci pfnAcquireFirstPathInfo rozhraní topologie VidPN pro získání ukazatele na strukturu D3DKMDT_VIDPN_PRESENT_PATH, která popisuje první cestu v topologii.

2. Rozhraní topologie VidPN

   Zavolejte funkci pfnAcquireNextPathInfo opakovaně, abyste získali ukazatele na struktury D3DKMDT_VIDPN_PRESENT_PATH, které popisují zbývající cesty v topologii.

Podobně může ovladač miniportu zobrazení získat deskriptory režimů v sadě režimů voláním funkcí pfnAcquireFirstModeInfo a pfnAcquireNextModeInfo kteréhokoli z následujících rozhraní sady režimů.

• DXGK_VIDPNSOURCEMODESET_INTERFACE

• DXGK_VIDPNTARGETMODESET_INTERFACE

• DXGK_MONITORSOURCEMODESET_INTERFACE

Všimněte si, že rozhraní DXGK_VIDPNSOURCEMODESET_INTERFACE nemá žádnou funkci pro odebrání režimu ze sady zdrojového režimu. Pokud ovladač miniportu zobrazení potřebuje aktualizovat sadu režimů, nezmění stávající sadu přidáváním a odebíráním režimů. Místo toho vytvoří novou sadu režimů, která nahradí starou sadu režimů. Příkladem funkce, která musí aktualizovat sady režimů, je funkce DxgkDdiEnumVidPnCofuncModality ovladače miniportu zobrazení. Kroky, které se týkají aktualizace sady zdrojového režimu, jsou následující:

1. Zavolejte funkci pfnCreateNewModeInfo rozhraní DXGK_VIDPNSOURCEMODESET_INTERFACE, abyste získali ukazatel na strukturu D3DKMDT_VIDPN_SOURCE_MODE, která je přidělená správcem VidPN.

   Opakovaně volejte pfnAddMode pro přidání režimů do souboru počátečních režimů.

2. Zavolejte funkci pfnAssignSourceModeSet rozhraní DXGK_VIDPN_INTERFACE pro přiřazení nové sady režimů ke konkrétnímu video zdroji zobrazení. Nová sada zdrojového režimu nahrazuje sadu zdrojového režimu, která je aktuálně přiřazena k danému zdroji.

Aktualizace sady cílových režimů se podobá aktualizaci sady zdrojového režimu. Rozhraní DXGK_VIDPNTARGETMODESET_INTERFACE má následující funkce:

• Rozhraní Sady cílových režimů VidPN

  Funkce pfnCreateNewModeInfo pro vytvoření nové sady cílových režimů a funkce pfnAddMode pro přidání režimů do sady.

Neexistuje žádné rozhraní (sada funkcí) pro získání zdroje a cíle, které patří do konkrétní cesty. Ovladač miniportu zobrazení může určit, který zdroj a cíl patří do konkrétní cesty kontrolou členů VidPnSourceId a VidPnTargetId struktury D3DKMDT_VIDPN_PRESENT_PATH, která představuje cestu.

Viz také

Určení, jestli je VidPN podporován na grafickém adaptéru

Výčet kofunkčních režimů zdrojů a cílů VidPN

video prezentující terminologii sítě

Získání dalších cílových režimů monitorování