DXGKDDI_MONITORSOURCEMODESET_ACQUIREPREFERREDMODEINFO fonction de rappel (d3dkmddi.h)

Article
02/06/2025

Le pfnAcquirePreferredModeInfo retourne un descripteur du mode préféré dans un objet de jeu de sources de 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 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 préféré, y compris son ID et son signal vidéo.

Valeur de retour

La fonction pfnAcquirePreferredModeInfo retourne l’une des valeurs suivantes.

Retourner le code	Description
STATUS_SUCCESS	La fonction a retourné un descripteur du mode préféré.
STATIS_GRAPHICS_NO_PREFERRED_MODE	La fonction a réussi, mais le jeu de mode source du moniteur spécifié n’a pas de mode préféré.
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.

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

Partager via