DXGKDDI_VIDPN_ACQUIRETARGETMODESET fonction de rappel (d3dkmddi.h)

Article
02/06/2025

La fonction pfnAcquireTargetModeSet retourne un handle à un objet défini en mode cible particulier contenu par un objet VidPN spécifié.

Syntaxe

DXGKDDI_VIDPN_ACQUIRETARGETMODESET DxgkddiVidpnAcquiretargetmodeset;

NTSTATUS DxgkddiVidpnAcquiretargetmodeset(
  [in]  IN_CONST_D3DKMDT_HVIDPN hVidPn,
  [in]  IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VidPnTargetId,
  [out] OUT_PD3DKMDT_HVIDPNTARGETMODESET phVidPnTargetModeSet,
  [out] DEREF_OUT_CONST_PPDXGK_VIDPNTARGETMODESET_INTERFACE ppVidPnTargetModeSetInterface
)
{...}

Paramètres

[in] hVidPn

Handle vers un objet VidPN. Le gestionnaire VidPN a précédemment fourni ce handle au pilote miniport d’affichage en appelant DxgkDdiEnumVidPnCofuncModality, DxgkDdiIsSupportedVidPn, ou DxgkDdiRecommendFunctionalVidPn.

[in] VidPnTargetId

Entier qui identifie l’une des cibles présentes de la vidéo associées à l’objet VidPN.

[out] phVidPnTargetModeSet

Pointeur vers une variable qui reçoit un handle vers l’objet défini en mode cible demandé.

[out] ppVidPnTargetModeSetInterface

Pointeur vers une variable qui reçoit un pointeur vers une structure DXGK_VIDPNTARGETMODESET_INTERFACE. La structure contient des pointeurs vers des fonctions que le pilote miniport d’affichage peut appeler pour inspecter et modifier l’objet défini en mode cible.

Valeur de retour

La fonction pfnAcquireTargetModeSet retourne l’une des valeurs suivantes :

Retourner le code	Description
STATUS_SUCCESS	La fonction a réussi.
STATUS_GRAPHICS_INVALID_VIDPN	Le handle fourni dans hVidPn n’était pas valide.
STATUS_GRAPHICS_INVALID_VIDEO_PRESENT_TARGET	L’identificateur fourni dans VidPnTargetId n’était pas valide.

Remarques

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

Lorsque vous avez terminé d’utiliser le handle d’objet défini en mode cible, vous devez libérer le handle en appelant pfnReleaseTargetModeSet. Les objets de jeu de mode cible sont référencés. Par conséquent, si vous obtenez un handle plusieurs fois, vous devez le libérer autant de fois.

La durée de vie de la structure DXGK_VIDPNTARGETMODESET_INTERFACE retournée dans ppVidPnTargetModeSetInterface appartient au système d’exploitation. À l’aide de ce schéma de propriété, le système d’exploitation peut basculer vers des implémentations plus récentes au moment de l’exécution sans interrompre les clients de l’interface.

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

Les types de données D3DKMDT_HVIDPN et D3DKMDT_HVIDPNTARGETMODESET sont définis dans D3dkmdt.h.