DXGKDDI_VIDPN_ACQUIRETARGETMODESET fonction de rappel (d3dkmddi.h)

  • Article

La fonction pfnAcquireTargetModeSet retourne un handle à un objet défini en mode cible particulier qui est 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 d’un objet VidPN. Le gestionnaire VidPN a précédemment fourni cette poignée au pilote de miniport d’affichage en appelant DxgkDdiEnumVidPnCofuncModality, DxgkDdiIsSupportedVidPn ou DxgkDdiRecommendFunctionalVidPn.

[in] VidPnTargetId

Entier qui identifie l’une des cibles présentes 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 de miniport d’affichage peut appeler pour inspecter et modifier l’objet défini du mode cible.

Valeur retournée

La fonction pfnAcquireTargetModeSet retourne l’une des valeurs suivantes :

Code de retour 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 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.

Une fois que 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 définis en mode cible sont comptabilisés en référence. Par conséquent, si vous acquérez un handle plusieurs fois, vous devez le libérer le même nombre 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 casser 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.

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

Interface définie du mode cible VidPN

pfnAssignTargetModeSet

pfnCreateNewTargetModeSet

pfnReleaseTargetModeSet