DXGKDDI_VIDPNTOPOLOGY_GETNUMPATHSFROMSOURCE fonction de rappel (d3dkmddi.h)

Article
02/27/2024

La fonction pfnGetNumPathsFromSource retourne le nombre de chemins d’accès vidéo présents qui contiennent une source vidéo présente spécifiée.

Syntaxe

DXGKDDI_VIDPNTOPOLOGY_GETNUMPATHSFROMSOURCE DxgkddiVidpntopologyGetnumpathsfromsource;

NTSTATUS DxgkddiVidpntopologyGetnumpathsfromsource(
  [in]  IN_CONST_D3DKMDT_HVIDPNTOPOLOGY hVidPnTopology,
  [in]  IN_CONST_D3DDDI_VIDEO_PRESENT_SOURCE_ID VidPnSourceId,
  [out] OUT_PSIZE_T pNumPathsFromSource
)
{...}

Paramètres

[in] hVidPnTopology

Handle pour un objet de topologie VidPN. Le pilote de miniport d’affichage a précédemment obtenu ce handle en appelant la fonction pfnGetTopology de l’interface DXGK_VIDPN_INTERFACE .

[in] VidPnSourceId

Entier qui identifie la source présente d’une vidéo particulière.

[out] pNumPathsFromSource

Pointeur vers une variable de type SIZE_T qui reçoit le nombre de chemins qui contiennent la source spécifiée.

Valeur retournée

La fonction pfnGetNumPathsFromSource retourne l’une des valeurs suivantes :

Code de retour	Description
STATUS_SUCCESS	La fonction a réussi.
STATUS_GRAPHICS_INVALID_VIDPN_TOPOLOGY	Le handle fourni dans hVidPnTopology n’était pas valide.
STATUS_INVALID_PARAMETER	Le pointeur fourni dans pNumPathsFromSource était valide.

Remarques

Une topologie est un chemin d’accès à une collection, chacun contenant une paire (source, cible). Il est possible qu’une source particulière apparaisse dans plusieurs chemins. Par exemple, une source peut être associée à deux cibles distinctes dans le cas d’une vue clone.

Les identificateurs de source VidPN sont attribués par le système d’exploitation. DxgkDdiStartDevice, implémenté par le pilote de miniport d’affichage, retourne le nombre N de sources vidéo présentes prises en charge par la carte graphique. Ensuite, le système d’exploitation affecte les identificateurs 0, 1, 2, ... N - 1.

Le type de données D3DKMDT_HVIDPNTOPOLOGY est défini dans D3dkmdt.h.

Le type de données D3DDDI_VIDEO_PRESENT_SOURCE_ID est défini dans D3dukmdt.h.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	d3dkmddi.h (include D3dkmddi.h)
IRQL	PASSIVE_LEVEL

Voir aussi

pfnGetNumPaths

Partager via