DXGKDDI_VIDPNTOPOLOGY_GETPATHSOURCEFROMTARGET fonction de rappel (d3dkmddi.h)

Article
02/23/2024

La fonction pfnGetPathSourceFromTarget retourne l’identificateur de la source présente de la vidéo associée à une cible vidéo présente spécifiée.

Syntaxe

DXGKDDI_VIDPNTOPOLOGY_GETPATHSOURCEFROMTARGET DxgkddiVidpntopologyGetpathsourcefromtarget;

NTSTATUS DxgkddiVidpntopologyGetpathsourcefromtarget(
  [in]  IN_CONST_D3DKMDT_HVIDPNTOPOLOGY hVidTopology,
  [in]  IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VidPnTargetId,
  [out] OUT_PD3DDDI_VIDEO_PRESENT_SOURCE_ID pVidPnSourceId
)
{...}

Paramètres

[in] hVidTopology

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

[in] VidPnTargetId

Entier qui identifie une source présente de vidéo particulière.

[out] pVidPnSourceId

Pointeur vers une variable qui reçoit l’identificateur de la source présente vidéo.

Valeur retournée

La fonction pfnGetPathSourceFromTarget 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 pVidPnSourceId était valide.

Remarques

Une topologie est un chemin d’accès de collection, chacun contenant une paire (source, cible). Une cible particulière appartient au plus à un chemin d’accès. Par conséquent, en fonction d’un ID cible, il existe au maximum une source associée à cette cible.

Les identificateurs sources 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 l’adaptateur d’affichage. Ensuite, le système d’exploitation affecte les identificateurs 0, 1, 2, ... N - 1.

Les identificateurs cibles VidPN sont attribués par le pilote de miniport d’affichage. DxgkDdiQueryChildRelations, implémenté par le pilote de miniport d’affichage, retourne un tableau de structures DXGK_CHILD_DESCRIPTOR , chacune contenant un identificateur.

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

Les types de données D3DDDI_VIDEO_PRESENT_SOURCE_ID D3DDDI_VIDEO_PRESENT_TARGET_ID sont définis 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 (inclure D3dkmddi.h)
IRQL	PASSIVE_LEVEL

Voir aussi

pfnEnumPathTargetsFromSource

Partager via