DXGKDDI_VIDPNTARGETMODESET_ACQUIREFIRSTMODEINFO fonction de rappel (d3dkmddi.h)

  • Article

La fonction pfnAcquireFirstModeInfo retourne un descripteur du premier mode dans un mode cible VidPN spécifié.

Syntaxe

DXGKDDI_VIDPNTARGETMODESET_ACQUIREFIRSTMODEINFO DxgkddiVidpntargetmodesetAcquirefirstmodeinfo;

NTSTATUS DxgkddiVidpntargetmodesetAcquirefirstmodeinfo(
  [in]  IN_CONST_D3DKMDT_HVIDPNTARGETMODESET hVidPnTargetModeSet,
  [out] DEREF_OUT_CONST_PPD3DKMDT_VIDPN_TARGET_MODE ppFirstVidPnTargetModeInfo
)
{...}

Paramètres

[in] hVidPnTargetModeSet

Handle vers un objet défini en mode cible VidPN. Le pilote miniport d’affichage a précédemment obtenu ce handle en appelant la fonction pfnAcquireTargetModeSet de l’interface DXGK_VIDPN_INTERFACE .

[out] ppFirstVidPnTargetModeInfo

Pointeur vers une variable qui reçoit un pointeur vers une structure D3DKMDT_VIDPN_TARGET_MODE . La structure contient diverses informations sur le mode cible, notamment ses caractéristiques d’ID et de signal vidéo.

Valeur retournée

La fonction pfnAcquireFirstModeInfo retourne l’une des valeurs suivantes :

Code de retour Description
STATUS_SUCCESS La fonction a réussi.
STATUS_GRAPHICS_INVALID_VIDPN_TARGETMODESET Le handle fourni dans hVidPnTargetModeSet n’était pas valide.

Remarques

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

Vous pouvez énumérer tous les modes qui appartiennent à un objet défini de mode cible VidPN en appelant pfnAcquireFirstModeInfo , puis en effectuant une séquence d’appels à pfnAcquireNextModeInfo.

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_TARGET_MODE

pfnAcquireNextModeInfo

pfnReleaseModeInfo