DXGKDDI_MONITOR_GETADDITIONALMONITORMODESET fonction de rappel (d3dkmddi.h)

Article
02/26/2024

La fonction pfnGetAdditionalMonitorModeSet retourne un handle à un objet de jeu de mode source de moniteur supplémentaire associé à un moniteur spécifié. Il est disponible dans l’interface DXGK_MONITOR_INTERFACE_V2 , à partir de Windows 7.

Syntaxe

DXGKDDI_MONITOR_GETADDITIONALMONITORMODESET DxgkddiMonitorGetadditionalmonitormodeset;

NTSTATUS DxgkddiMonitorGetadditionalmonitormodeset(
  [in]  IN_CONST_D3DKMDT_ADAPTER hAdapter,
  [in]  IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VideoPresentTargetId,
  [out] OUT_PUINT pNumberModes,
  [out] DEREF_ECOUNT_PPDXGK_TARGETMODE_DETAIL_TIMING ppAdditionalModesSet
)
{...}

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 modes supplémentaires ppAdditionalModesSet retourné décrit les ensembles de modes source supplémentaires disponibles sur le moniteur connecté à cette cible vidéo présente.

[out] pNumberModes

Pointeur vers une variable qui contient le nombre de modes de minutage supplémentaires de la cible de présentation vidéo spécifiée par VideoPresentTargetId.

[out] ppAdditionalModesSet

Pointeur vers une variable qui reçoit un pointeur vers une structure DXGK_TARGETMODE_DETAIL_TIMING . La structure décrit les modes de minutage supplémentaires d’une cible de présentation vidéo compatibles avec l’appareil d’affichage.

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.
STATUS_NOT_FOUND	La cible de la vidéo présente identifiée par VideoPresentTargetId est introuvable.

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.

Cette fonction est disponible à partir de Windows 7.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	d3dkmddi.h (inclure D3dkmddi.h)
IRQL	PASSIVE_LEVEL