DXGKDDI_MONITOR_GETMONITORFREQUENCYRANGESET fonction de rappel (d3dkmddi.h)

  • Article

La fonction pfnGetMonitorFrequencyRangeSet retourne un handle à l’objet défini sur la plage de fréquences du moniteur associé à un moniteur spécifié.

Syntaxe

DXGKDDI_MONITOR_GETMONITORFREQUENCYRANGESET DxgkddiMonitorGetmonitorfrequencyrangeset;

NTSTATUS DxgkddiMonitorGetmonitorfrequencyrangeset(
  [in]  IN_CONST_D3DKMDT_ADAPTER hAdapter,
  [in]  IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VideoPresentTargetId,
  [out] OUT_PD3DKMDT_HMONITORFREQUENCYRANGESET phMonitorFrequencyRangeSet,
  [out] DEREF_OUT_CONST_PPDXGK_MONITORFREQUENCYRANGESET_INTERFACE ppMonitorFrequencyRangeSetInterface
)
{...}

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’ensemble de plages de fréquences du moniteur retourné décrit les plages de fréquences disponibles sur l’écran connecté à cette cible vidéo présente.

[out] phMonitorFrequencyRangeSet

Pointeur vers une variable qui reçoit un handle vers l’objet défini sur la plage de fréquences du moniteur.

[out] ppMonitorFrequencyRangeSetInterface

Pointeur vers une variable qui reçoit un pointeur vers une structure DXGK_MONITORFREQUENCYRANGESET_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 sur la plage de fréquences du moniteur.

Valeur retournée

La fonction pfnGetMonitorFrequencyRangeSet 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 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. LafonctionDxgkDdiQueryChildRelations, implémentée par le pilote 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 phMonitorFrequencyRangeSet.

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