DXGKDDI_VIDPNTARGETMODESET_ADDMODE fonction de rappel (d3dkmddi.h)
La fonction pfnAddMode ajoute un mode cible VidPN à un objet défini en mode cible VidPN spécifié.
Syntaxe
DXGKDDI_VIDPNTARGETMODESET_ADDMODE DxgkddiVidpntargetmodesetAddmode;
NTSTATUS DxgkddiVidpntargetmodesetAddmode(
[in] IN_D3DKMDT_HVIDPNTARGETMODESET hVidPnTargetModeSet,
[in] IN_PD3DKMDT_VIDPN_TARGET_MODE_CONST pVidPnTargetModeInfo
)
{...}
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] pVidPnTargetModeInfo
Pointeur vers une structure D3DKMDT_VIDPN_TARGET_MODE qui décrit le mode cible. Le pilote miniport d’affichage a précédemment obtenu cette structure en appelant pfnCreateNewModeInfo.
Valeur retournée
La fonction pfnAddMode 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. |
Remarques
Pour ajouter un mode à un ensemble de modes cibles, le pilote miniport d’affichage effectue les étapes suivantes.
- Appelez pfnCreateNewModeInfo pour obtenir un pointeur vers une structure D3DKMDT_VIDPN_TARGET_MODE . La fonction pnfCreateNewModeInfo alloue la structure et remplit le membre ID avec un identificateur de mode cible nouvellement généré.
- Le membre Info de la structure D3DKMDT_VIDPN_TARGET_MODE est une structure D3DKMDT_VIDEO_SIGNAL_MODE . Renseignez cette structure avec des informations sur le mode.
- Appelez pfnAddMode pour ajouter le mode à un ensemble de modes cibles.
Si vous obtenez une structure D3DKMDT_VIDPN_TARGET_MODE en appelant pfnCreateNewModeInfo et que vous décidez de ne pas ajouter ce mode à un ensemble de modes cibles, vous devez libérer explicitement la structure en appelant pfnReleaseModeInfo.
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 |