DXGKDDI_MONITOR_GETADDITIONALMONITORMODESET fonction de rappel (d3dkmddi.h)

Article
02/06/2025

La fonction pfnGetAdditionalMonitorModeSet retourne un handle à un objet de jeu de modes 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 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. Le ppAdditionalModesSet retourné'objet de jeu de modes supplémentaires décrit les jeux de modes sources de moniteur supplémentaires disponibles sur le moniteur connecté à cette cible présente vidéo.

[out] pNumberModes

Pointeur vers une variable qui contient le nombre de modes de minutage supplémentaires de la vidéo présente cible 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 qui sont compatibles avec l’appareil d’affichage.

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.
STATUS_NOT_FOUND	Impossible de trouver la cible présente par VideoPresentTargetId.

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.

Cette fonction est disponible à partir de Windows 7.