DXGKDDI_MONITOR_GETMONITORDESCRIPTORSET fonction de rappel (d3dkmddi.h)
La fonction pfnGetMonitorDescriptorSet retourne un handle à un objet de jeu de descripteur de moniteur associé à un moniteur spécifié.
Syntaxe
DXGKDDI_MONITOR_GETMONITORDESCRIPTORSET DxgkddiMonitorGetmonitordescriptorset;
NTSTATUS DxgkddiMonitorGetmonitordescriptorset(
[in] IN_CONST_D3DKMDT_ADAPTER hAdapter,
[in] IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VideoPresentTargetId,
[out] OUT_PD3DKMDT_HMONITORDESCRIPTORSET phMonitorDescriptorSet,
[out] DEREF_OUT_CONST_PPDXGK_MONITORDESCRIPTORSET_INTERFACE ppMonitorDescriptorSetInterface
)
{...}
Paramètres
[in] hAdapter
Handle qui identifie un adaptateur d’affichage. Le sous-système du noyau graphique Microsoft DirectX fournissait précédemment 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 de la vidéo présente sur l’adaptateur d’affichage. L’objet de jeu de descripteur de moniteur retourné contient des descripteurs pour le moniteur connecté à cette vidéo cible présente.
[out] phMonitorDescriptorSet
Pointeur vers une variable qui reçoit un handle vers un objet de jeu de descripteur de surveillance.
[out] ppMonitorDescriptorSetInterface
Pointeur vers une variable qui reçoit un pointeur vers une structure DXGK_MONITORDESCRIPTORSET_INTERFACE . La structure contient des pointeurs vers des fonctions que le pilote de miniport d’affichage peut appeler pour inspecter et modifier l’objet set de descripteur de moniteur.
Valeur retournée
La fonction pfnGetMonitorDescriptorSet retourne l’une des valeurs suivantes.
| Code de retour | Description |
|---|---|
| STATUS_SUCCESS | La fonction a réussi. |
| STATUS_INVALID_PARAMETER | Un paramètre non valide a été fourni. |
| 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 actuelle de la vidéo identifiée par VideoPresentTargetId. |
Remarques
Les identificateurs de cible VidPN sont attribués par le pilote de miniport d’affichage. La fonction DxgkDdiQueryChildRelations , implémentée par le pilote de miniport d’affichage, retourne un tableau de structures DXGK_CHILD_DESCRIPTOR , chacune contenant un identificateur.
Vous n’avez pas besoin de libérer le handle retourné dans phMonitorDescriptorSet.
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 (include D3dkmddi.h) |
| IRQL | PASSIVE_LEVEL |