DXGKDDI_MONITOR_ACQUIREMONITORSOURCEMODESET fonction de rappel (d3dkmddi.h)

Article
05/26/2023

La fonction pfnAcquireMonitorSourceModeSet retourne un handle à l’objet défini du mode source du moniteur associé à un moniteur spécifié.

Syntaxe

DXGKDDI_MONITOR_ACQUIREMONITORSOURCEMODESET DxgkddiMonitorAcquiremonitorsourcemodeset;

NTSTATUS DxgkddiMonitorAcquiremonitorsourcemodeset(
  [in]  IN_CONST_D3DKMDT_ADAPTER hAdapter,
  [in]  IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VideoPresentTargetId,
  [out] OUT_PD3DKMDT_HMONITORSOURCEMODESET phMonitorSourceModeSet,
  [out] DEREF_OUT_CONST_PPDXGK_MONITORSOURCEMODESET_INTERFACE ppMonitorSourceModeSetInterface
)
{...}

Paramètres

[in] hAdapter

Handle qui identifie une carte d’affichage. Le sous-système du noyau graphique Microsoft DirectX a précédemment fourni ce handle au pilote miniport d’affichage dans le paramètre DxgkInterface de la fonction DxgkDdiStartDevice .

[in] VideoPresentTargetId

Entier qui identifie l’une des cibles vidéo présentes sur l’adaptateur d’affichage. L’objet défini de mode source retourné décrit les modes disponibles sur le moniteur connecté à cette cible de présentation vidéo.

[out] phMonitorSourceModeSet

Pointeur vers une variable qui reçoit un handle vers un objet défini en mode source du moniteur.

[out] ppMonitorSourceModeSetInterface

Pointeur vers une variable qui reçoit un pointeur vers une structure DXGK_MONITORSOURCEMODESET_INTERFACE . La structure contient des pointeurs vers des fonctions que le pilote de miniport d’affichage peut appeler pour inspecter et modifier l’objet défini du mode source du moniteur.

Valeur retournée

La fonction pfnAcquireMonitorSourceModeSet retourne l’une des valeurs suivantes.

Code de retour	Description
STATUS_SUCCESS	La fonction a réussi.
STATUS_GRAPHICS_INVALID_DISPLAY_ADAPTER	Le handle fourni dans hAdapter n’était pas valide.
STATUS_GRAPHICS_INVALID_VIDEO_PRESENT_TARGET	L’identificateur fourni dans VideoPresentTargetId n’était pas valide.
STATUS_GRAPHICS_MONITOR_NOT_CONNECTED	Aucun moniteur n’est connecté à la cible vidéo présente identifiée par VideoPresentTargetId.

Cette fonction peut également retourner d’autres codes d’erreur définis dans Ntstatus.h.

Remarques

Les identificateurs cibles VidPN sont attribués par le pilote de miniport d’affichage. La fonction DxgkDdiQueryChildRelations , implémentée par le pilote miniport d’affichage, retourne un tableau de structures DXGK_CHILD_DESCRIPTOR , chacune contenant un identificateur.

Une fois que vous avez terminé d’utiliser le handle d’objet défini en mode source du moniteur, vous devez libérer le handle en appelant pfnReleaseMonitorSourceModeSet. Les objets définis en mode cible sont comptabilisés en référence. Par conséquent, si vous acquérez un handle plusieurs fois, vous devez le libérer le même nombre de fois.

Cette fonction est également disponible dans l’interface DXGK_MONITOR_INTERFACE_V2 à partir de Windows 7.

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

Voir aussi

DXGK_MONITOR_INTERFACE_V2

DxgkDdiEnumVidPnCofuncModality

Partager via