DXGKDDI_MONITORSOURCEMODESET_ACQUIREPREFERREDMODEINFO fonction de rappel (d3dkmddi.h)

Article
02/23/2024

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

Partager via