DXGKDDI_VIDPN_ACQUIRESOURCEMODESET fonction de rappel (d3dkmddi.h)
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 |