DXGKDDI_MONITORSOURCEMODESET_ACQUIREFIRSTMODEINFO fonction de rappel (d3dkmddi.h)
La fonction pfnAcquireFirstModeInfo retourne un descripteur du premier mode dans un jeu de mode source de moniteur spécifié.
Syntaxe
DXGKDDI_MONITORSOURCEMODESET_ACQUIREFIRSTMODEINFO DxgkddiMonitorsourcemodesetAcquirefirstmodeinfo;
NTSTATUS DxgkddiMonitorsourcemodesetAcquirefirstmodeinfo(
[in] IN_CONST_D3DKMDT_HMONITORSOURCEMODESET hMonitorSourceModeSet,
[out] DEREF_OUT_CONST_PPD3DKMDT_MONITOR_SOURCE_MODE ppFirstMonitorSourceModeInfo
)
{...}
Paramètres
[in] hMonitorSourceModeSet
Handle vers un objet de jeu de mode source monitor. Le pilote miniport d’affichage a précédemment obtenu ce handle en appelant la fonction pfnAcquireMonitorSourceModeSet de l’interface Monitor.
[out] ppFirstMonitorSourceModeInfo
Pointeur vers une variable qui reçoit un pointeur vers une structure D3DKMDT_MONITOR_SOURCE_MODE. La structure contient diverses informations sur le mode source du moniteur, y compris ses caractéristiques d’ID et de signal vidéo.
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_MONITOR_SOURCEMODESET | Le handle fourni dans hMonitorSourceModeSet n’était pas valide. |
Remarques
Lorsque vous avez terminé d’utiliser la structure D3DKMDT_MONITOR_SOURCE_MODE, vous devez libérer la structure en appelant pfnReleaseModeInfo.
Vous pouvez énumérer tous les modes appartenant à un objet défini de mode source de moniteur VidPN en appelant pfnAcquireFirstModeInfo, puis en effectuant une séquence d’appels à pfnAcquireNextModeInfo.
Le type de données D3DKMDT_HMONITORSOURCEMODESET est défini dans D3dkmdt.h.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows Vista |
| plateforme cible | Bureau |
| d’en-tête | d3dkmddi.h (include D3dkmddi.h) |
| IRQL | PASSIVE_LEVEL |