DXGKDDI_MONITOR_ACQUIREMONITORSOURCEMODESET fonction de rappel (d3dkmddi.h)
La fonction pfnAcquireMonitorSourceModeSet retourne un handle à l’objet de jeu de modes 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 un adaptateur 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 présentes de la vidéo sur l’adaptateur d’affichage. L’objet de jeu de modes source retourné décrit les modes disponibles sur le moniteur connecté à cette cible présente vidéo.
[out] phMonitorSourceModeSet
Pointeur vers une variable qui reçoit un handle vers un objet de jeu de mode source monitor.
[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 miniport d’affichage peut appeler pour inspecter et modifier l’objet de jeu de modes source du moniteur.
Valeur de retour
La fonction pfnAcquireMonitorSourceModeSet retourne l’une des valeurs suivantes.
| Retourner le code | 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 vidéo cible 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 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 du jeu d’objets du jeu de modes source du moniteur, vous devez libérer le handle en appelant pfnReleaseMonitorSourceModeSet. Les objets de jeu de mode cible sont référencés. Par conséquent, si vous obtenez un handle plusieurs fois, vous devez le libérer autant de fois.
Cette fonction est également disponible dans l’interface DXGK_MONITOR_INTERFACE_V2 à partir de Windows 7.
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 |