DXGKDDI_VIDPN_ACQUIRETARGETMODESET fonction de rappel (d3dkmddi.h)
La fonction pfnAcquireTargetModeSet retourne un handle à un objet défini en mode cible particulier qui est contenu par un objet VidPN spécifié.
Syntaxe
DXGKDDI_VIDPN_ACQUIRETARGETMODESET DxgkddiVidpnAcquiretargetmodeset;
NTSTATUS DxgkddiVidpnAcquiretargetmodeset(
[in] IN_CONST_D3DKMDT_HVIDPN hVidPn,
[in] IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VidPnTargetId,
[out] OUT_PD3DKMDT_HVIDPNTARGETMODESET phVidPnTargetModeSet,
[out] DEREF_OUT_CONST_PPDXGK_VIDPNTARGETMODESET_INTERFACE ppVidPnTargetModeSetInterface
)
{...}
Paramètres
[in] hVidPn
Handle d’un objet VidPN. Le gestionnaire VidPN a précédemment fourni cette poignée au pilote de miniport d’affichage en appelant DxgkDdiEnumVidPnCofuncModality, DxgkDdiIsSupportedVidPn ou DxgkDdiRecommendFunctionalVidPn.
[in] VidPnTargetId
Entier qui identifie l’une des cibles présentes vidéo associées à l’objet VidPN.
[out] phVidPnTargetModeSet
Pointeur vers une variable qui reçoit un handle vers l’objet défini en mode cible demandé.
[out] ppVidPnTargetModeSetInterface
Pointeur vers une variable qui reçoit un pointeur vers une structure DXGK_VIDPNTARGETMODESET_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 cible.
Valeur retournée
La fonction pfnAcquireTargetModeSet 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_TARGET | L’identificateur fourni dans VidPnTargetId n’était pas valide. |
Remarques
Les identificateurs cibles VidPN sont attribués par le pilote de miniport d’affichage. DxgkDdiQueryChildRelations, implémenté par le pilote de miniport d’affichage, retourne un tableau de structures DXGK_CHILD_DESCRIPTOR , chacune contenant un identificateur.
Une fois que vous avez terminé d’utiliser le handle d’objet défini en mode cible, vous devez libérer le handle en appelant pfnReleaseTargetModeSet. Les objets définis en mode cible 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_VIDPNTARGETMODESET_INTERFACE retournée dans ppVidPnTargetModeSetInterface 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_TARGET_ID est défini dans D3dukmdt.h.
Les types de données D3DKMDT_HVIDPN et D3DKMDT_HVIDPNTARGETMODESET 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 (inclure D3dkmddi.h) |
| IRQL | PASSIVE_LEVEL |