DXGKDDI_VIDPN_ACQUIRESOURCEMODESET fonction de rappel (d3dkmddi.h)

  • Article

La fonction pfnAcquireSourceModeSet retourne un handle à un objet de jeu de mode source particulier contenu par un objet VidPN spécifié.

Syntaxe

DXGKDDI_VIDPN_ACQUIRESOURCEMODESET DxgkddiVidpnAcquiresourcemodeset;

NTSTATUS DxgkddiVidpnAcquiresourcemodeset(
  [in]  IN_CONST_D3DKMDT_HVIDPN hVidPn,
  [in]  IN_CONST_D3DDDI_VIDEO_PRESENT_SOURCE_ID VidPnSourceId,
  [out] OUT_PD3DKMDT_HVIDPNSOURCEMODESET phVidPnSourceModeSet,
  [out] DEREF_OUT_CONST_PPDXGK_VIDPNSOURCEMODESET_INTERFACE ppVidPnSourceModeSetInterface
)
{...}

Paramètres

[in] hVidPn

Handle pour un objet VidPN. Le gestionnaire VidPN a précédemment fourni ce handle au pilote de miniport d’affichage en appelant DxgkDdiEnumVidPnCofuncModality, DxgkDdiIsSupportedVidPn ou DxgkDdiRecommendFunctionalVidPn.

[in] VidPnSourceId

Entier qui identifie l’une des sources présentes de la vidéo associées à l’objet VidPN.

[out] phVidPnSourceModeSet

Pointeur vers une variable qui reçoit un handle vers l’objet défini du mode source demandé.

[out] ppVidPnSourceModeSetInterface

Pointeur vers une variable qui reçoit un pointeur vers une structure DXGK_VIDPNSOURCEMODESET_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 du mode source.

Valeur retournée

La fonction pfnAcquireSourceModeSet retourne l’une des valeurs suivantes :

Code de retour Description
STATUS_SUCCESS La fonction a réussi.
STATUS_GRAPHICS_INVALID_VIDPN Le handle fourni dans hVidPn n’était pas valide.
STATUS_GRAPHICS_INVALID_VIDEO_PRESENT_SOURCE L’identificateur fourni dans VidPnSourceId n’était pas valide.

Remarques

Les identificateurs de source VidPN sont attribués par le système d’exploitation. DxgkDdiStartDevice, implémenté par le pilote de miniport d’affichage, retourne le nombre N de sources vidéo présentes prises en charge par la carte graphique. Ensuite, le système d’exploitation affecte les identificateurs 0, 1, 2, ... N - 1.

Une fois que vous avez terminé d’utiliser le handle d’objet défini en mode source, vous devez libérer le handle en appelant pfnReleaseSourceModeSet. Les objets définis en mode source sont comptabilisés en référence. Par conséquent, si vous acquérez un handle plusieurs fois, vous devez le libérer le même nombre de fois.

La durée de vie de la structure DXGK_VIDPNSOURCEMODESET_INTERFACE retournée dans ppVidPnSourceModeSetInterface appartient au système d’exploitation. À l’aide de ce schéma de propriété, le système d’exploitation peut basculer vers des implémentations plus récentes au moment de l’exécution sans casser les clients de l’interface.

Le type de données D3DDDI_VIDEO_PRESENT_SOURCE_ID est défini dans D3dukmdt.h.

Les types de données D3DKMDT_HVIDPN et D3DKMDT_HVIDPNSOURCEMODESET sont définis 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 (include D3dkmddi.h)
IRQL PASSIVE_LEVEL

Voir aussi

Interface d’ensemble du mode source VidPN

pfnAssignTargetModeSet

pfnCreateNewSourceModeSet

pfnReleaseTargetModeSet