DXGKDDI_VIDPNTARGETMODESET_ACQUIREPINNEDMODEINFO fonction de rappel (d3dkmddi.h)

La fonction pfnAcquirePinnedModeInfo retourne un descripteur du mode épinglé dans un ensemble de modes cibles VidPN spécifié.

Syntaxe

DXGKDDI_VIDPNTARGETMODESET_ACQUIREPINNEDMODEINFO DxgkddiVidpntargetmodesetAcquirepinnedmodeinfo;

NTSTATUS DxgkddiVidpntargetmodesetAcquirepinnedmodeinfo(
  [in]  IN_CONST_D3DKMDT_HVIDPNTARGETMODESET hVidPnTargetModeSet,
  [out] DEREF_OUT_CONST_PPD3DKMDT_VIDPN_TARGET_MODE ppPinnedVidPnTargetModeInfo
)
{...}

Paramètres

[in] hVidPnTargetModeSet

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

[out] ppPinnedVidPnTargetModeInfo

Pointeur vers une variable qui reçoit un pointeur vers une structure D3DKMDT_VIDPN_TARGET_MODE . La structure contient diverses informations sur le mode épinglé, notamment ses caractéristiques d’ID et de signal vidéo. Si le mode cible défini identifié par hVidPnTargetModeSet n’a pas de mode épinglé, cette variable reçoit un pointeur NULL .

Valeur retournée

La fonction pfnAcquirePinnedModeInfo retourne l’une des valeurs suivantes :

Code de retour	Description
STATUS_SUCCESS	La fonction a réussi en effectuant l’une des opérations suivantes : 1. Définition de ppPinnedVidPnTargetModeInfo sur l’adresse de D3DKMDT_VIDPN_TARGET_MODE structure qui décrit le mode épinglé. 2. Définition de ppPinnedVidPnTargetModeInfo sur NULL pour indiquer que le mode cible défini n’a pas de mode épinglé.
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.

Le type de données D3DKMDT_HVIDPNTARGETMODESET est défini 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 (include D3dkmddi.h)
IRQL	PASSIVE_LEVEL

Voir aussi

D3DKMDT_VIDPN_TARGET_MODE

pfnPinMode

pfnReleaseModeInfo