DXGKDDI_MONITORSOURCEMODESET_ACQUIREPREFERREDMODEINFO fonction de rappel (d3dkmddi.h)

  • Article

Le pfnAcquirePreferredModeInfo retourne un descripteur du mode préféré dans un objet défini de mode source du moniteur spécifié.

Syntaxe

DXGKDDI_MONITORSOURCEMODESET_ACQUIREPREFERREDMODEINFO DxgkddiMonitorsourcemodesetAcquirepreferredmodeinfo;

NTSTATUS DxgkddiMonitorsourcemodesetAcquirepreferredmodeinfo(
  [in]  IN_CONST_D3DKMDT_HMONITORSOURCEMODESET hMonitorSourceModeSet,
  [out] DEREF_OUT_CONST_PPD3DKMDT_MONITOR_SOURCE_MODE ppFirstMonitorSourceModeInfo
)
{...}

Paramètres

[in] hMonitorSourceModeSet

Handle d’un objet set en 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 par défaut, notamment son ID et son signal vidéo.

Valeur retournée

La fonction pfnAcquirePreferredModeInfo retourne l’une des valeurs suivantes.

Code de retour Description
STATUS_SUCCESS La fonction a correctement retourné un descripteur du mode préféré.
STATIS_GRAPHICS_NO_PREFERRED_MODE La fonction a réussi, mais le mode source du moniteur spécifié défini n’a pas de mode préféré.
STATUS_GRAPHICS_INVALID_MONITOR_SOURCEMODESET Le handle fourni dans hMonitorSourceModeSet n’était pas valide.

Remarques

Une fois que vous avez terminé d’utiliser la structure D3DKMDT_MONITOR_SOURCE_MODE , vous devez libérer la structure en appelant pfnReleaseModeInfo.

Le type de données D3DKMDT_HMONITORSOURCEMODESET 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