DXGKDDI_VIDPNSOURCEMODESET_ACQUIRENEXTMODEINFO fonction de rappel (d3dkmddi.h)
La fonction pfnAcquireNextModeInfo retourne un descripteur du mode suivant dans un mode source VidPN spécifié, compte tenu du mode actuel.
Syntaxe
DXGKDDI_VIDPNSOURCEMODESET_ACQUIRENEXTMODEINFO DxgkddiVidpnsourcemodesetAcquirenextmodeinfo;
NTSTATUS DxgkddiVidpnsourcemodesetAcquirenextmodeinfo(
[in] IN_CONST_D3DKMDT_HVIDPNSOURCEMODESET hVidPnSourceModeSet,
[in] IN_CONST_PD3DKMDT_VIDPN_SOURCE_MODE_CONST pVidPnSourceModeInfo,
[out] DEREF_OUT_CONST_PPD3DKMDT_VIDPN_SOURCE_MODE ppNextVidPnSourceModeInfo
)
{...}
Paramètres
[in] hVidPnSourceModeSet
Handle vers un objet défini en mode source VidPN. Le pilote miniport d’affichage a précédemment obtenu ce handle en appelant la fonction pfnAcquireSourceModeSet de l’interface DXGK_VIDPN_INTERFACE .
[in] pVidPnSourceModeInfo
Pointeur vers une structure D3DKMDT_VIDPN_SOURCE_MODE qui décrit le mode actuel. Le pilote miniport d’affichage a précédemment obtenu ce pointeur en appelant pfnAcquireFirstModeInfo ou pfnAcquireNextModeInfo.
[out] ppNextVidPnSourceModeInfo
Pointeur vers une variable qui reçoit un pointeur vers une structure D3DKMDT_VIDPN_SOURCE_MODE qui décrit le mode suivant.
Valeur retournée
La fonction pfnAcquireNextModeInfo retourne l’une des valeurs suivantes :
| Code de retour | Description |
|---|---|
| STATUS_SUCCESS | La fonction a réussi. |
| STATUS_GRAPHICS_INVALID_VIDPN_SOURCEMODESET | Le handle fourni dans hVidPnSourceModeSet n’était pas valide. |
Remarques
Une fois que 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 qui appartiennent à un objet défini de 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.
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 |