DXGKDDI_VIDPNTARGETMODESET_PINMODE fonction de rappel (d3dkmddi.h)

Article
02/23/2024

La fonction pfnPinMode épingle un mode spécifié dans un ensemble de modes cibles VidPN.

Syntaxe

DXGKDDI_VIDPNTARGETMODESET_PINMODE DxgkddiVidpntargetmodesetPinmode;

NTSTATUS DxgkddiVidpntargetmodesetPinmode(
  [in] IN_D3DKMDT_HVIDPNTARGETMODESET hVidPnTargetModeSet,
  [in] IN_CONST_D3DKMDT_VIDEO_PRESENT_TARGET_MODE_ID VidPnTargetModeId
)
{...}

Paramètres

[in] hVidPnTargetModeSet

Handle vers un objet défini en mode cible VidPN. Le pilote miniport d’affichage a précédemment obtenu ce handle en appelant la fonction pfnAcquireTargetModeSet de l’interface DXGK_VIDPN_INTERFACE .

[in] VidPnTargetModeId

Entier qui identifie le mode à épingler.

Valeur retournée

La fonction pfnPinMode retourne l’une des valeurs suivantes :

Code de retour	Description
STATUS_SUCCESS	La fonction a réussi.
STATUS_GRAPHICS_INVALID_VIDPN_TARGETMODESET	Le handle fourni dans hVidPnTargetModeSet n’était pas valide.
STATUS_GRAPHICS_INVALID_VIDEO_PRESENT_TARGET_MODE	Le mode identifié par VidPnTargetModeId n’appartient pas au mode source défini par hVidPnTargetModeSet.

Remarques

Les identificateurs de mode cible VidPN sont attribués par le système d’exploitation. La fonction pfnCreateNewModeInfo génère un identificateur de mode, affecte l’identificateur au membre ID d’une structure D3DKMDT_VIDPN_TARGET_MODE et retourne la structure au pilote de miniport d’affichage.

Le type de données D3DKMDT_HVIDPNTARGETMODESET est défini dans D3dkmdt.h.

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