DXGKDDI_VIDPNTOPOLOGY_ACQUIREPATHINFO fonction de rappel (d3dkmddi.h)

  • Article

La fonction pfnAcquirePathInfo retourne un descripteur du chemin d’accès présent de la vidéo spécifié par une source de présentation vidéo et une cible de présentation vidéo dans une topologie VidPN particulière.

Syntaxe

DXGKDDI_VIDPNTOPOLOGY_ACQUIREPATHINFO DxgkddiVidpntopologyAcquirepathinfo;

NTSTATUS DxgkddiVidpntopologyAcquirepathinfo(
  [in]  IN_CONST_D3DKMDT_HVIDPNTOPOLOGY hVidPnTopology,
  [in]  IN_CONST_D3DDDI_VIDEO_PRESENT_SOURCE_ID VidPnSourceId,
  [in]  IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VidPnTargetId,
  [out] DEREF_OUT_CONST_PPD3DKMDT_VIDPN_PRESENT_PATH ppVidPnPresentPathInfo
)
{...}

Paramètres

[in] hVidPnTopology

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] VidPnSourceId

Entier qui identifie une source présente vidéo.

[in] VidPnTargetId

Entier qui identifie une cible de présentation vidéo.

[out] ppVidPnPresentPathInfo

Pointeur vers une variable qui reçoit un pointeur vers une structure D3DKMDT_VIDPN_PRESENT_PATH qui décrit le chemin d’accès demandé.

Valeur retournée

La fonction pfnAcquirePathInfo 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.

Remarques

Une fois que vous avez terminé d’utiliser la structure D3DKMDT_VIDPN_PRESENT_PATH, vous devez libérer la structure en appelant pfnReleasePathInfo.

Un chemin d’accès contient une paire (source, cible) et une topologie est une collection de chemins d’accès. Cette fonction retourne un descripteur pour le chemin d’accès, dans une topologie spécifiée, qui contient une paire spécifiée (source, cible).

Vous pouvez énumérer tous les chemins d’accès qui appartiennent à un objet de topologie VidPN en appelant pfnAcquireFirstPathInfo , puis en effectuant une séquence d’appels à pfnAcquireNextPathInfo.

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 et 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

D3DKMDT_VIDPN_PRESENT_PATH

pfnAcquireFirstPathInfo

pfnAcquireNextPathInfo

pfnReleasePathInfo