DXGKDDI_VIDPNSOURCEMODESET_ACQUIREFIRSTMODEINFO fonction de rappel (d3dkmddi.h)

2025-02-06

La fonction pfnAcquireFirstModeInfo retourne un descripteur du premier mode dans un jeu de mode source VidPN spécifié.

Syntaxe

DXGKDDI_VIDPNSOURCEMODESET_ACQUIREFIRSTMODEINFO DxgkddiVidpnsourcemodesetAcquirefirstmodeinfo;

NTSTATUS DxgkddiVidpnsourcemodesetAcquirefirstmodeinfo(
  [in]  IN_CONST_D3DKMDT_HVIDPNSOURCEMODESET hVidPnSourceModeSet,
  [out] DEREF_OUT_CONST_PPD3DKMDT_VIDPN_SOURCE_MODE ppFirstVidPnSourceModeInfo
)
{...}

Paramètres

[in] hVidPnSourceModeSet

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

[out] ppFirstVidPnSourceModeInfo

Pointeur vers une variable qui reçoit un pointeur vers une structure D3DKMDT_VIDPN_SOURCE_MODE. La structure contient diverses informations sur le mode, notamment son ID, son type et son format de rendu.

Valeur de retour

La fonction pfnAcquireFirstModeInfo retourne l’une des valeurs suivantes :

Retourner le code	Description
STATUS_SUCCESS	La fonction a réussi.
STATUS_GRAPHICS_INVALID_VIDPN_SOURCEMODESET	Le handle fourni dans hVidPnSourceModeSet n’était pas valide.

Remarques

Lorsque vous avez terminé d’utiliser la structure D3DKMDT_VIDPN_SOURCE_MODE, vous devez libérer la structure en appelant pfnReleaseModeInfo.

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

Le type de données D3DKMDT_HVIDPNSOURCEMODESET est défini dans D3dkmdt.h.