DXGKDDI_VIDPNSOURCEMODESET_ACQUIREPINNEDMODEINFO fonction de rappel (d3dkmddi.h)
La fonction pfnAcquirePinnedModeInfo retourne un descripteur du mode épinglé dans un ensemble de modes sources VidPN spécifié.
Syntaxe
DXGKDDI_VIDPNSOURCEMODESET_ACQUIREPINNEDMODEINFO DxgkddiVidpnsourcemodesetAcquirepinnedmodeinfo;
NTSTATUS DxgkddiVidpnsourcemodesetAcquirepinnedmodeinfo(
[in] IN_CONST_D3DKMDT_HVIDPNSOURCEMODESET hVidPnSourceModeSet,
[out] DEREF_OUT_CONST_PPD3DKMDT_VIDPN_SOURCE_MODE ppPinnedVidPnSourceModeInfo
)
{...}
Paramètres
[in] hVidPnSourceModeSet
Handle vers un objet défini en mode source VidPN. Le pilote de miniport d’affichage a précédemment obtenu ce handle en appelant la fonction pfnAcquireSourceModeSet de l’interface DXGK_VIDPN_INTERFACE .
[out] ppPinnedVidPnSourceModeInfo
Pointeur vers une variable qui reçoit un pointeur vers une structure D3DKMDT_VIDPN_SOURCE_MODE . La structure contient diverses informations sur le mode épinglé, notamment son ID, son type et son format de rendu. Si le mode source défini par hVidPnSourceModeSet 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 ppPinnedVidPnSourceModeInfo sur l’adresse de D3DKMDT_VIDPN_SOURCE_MODE structure qui décrit le mode épinglé. 2. Définition de ppPinnedVidPnSourceModeInfo sur NULL pour indiquer que le mode source défini n’a pas de mode épinglé. |
| 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.
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 (include D3dkmddi.h) |
| IRQL | PASSIVE_LEVEL |