DXGKCB_MULTIPLANEOVERLAYDISABLED fonction de rappel (d3dkmddi.h)
Un pilote miniport d’affichage en mode noyau appelle DXGKCB_MULTIPLANEOVERLAYDISABLED pour indiquer que la configuration actuelle de superposition multiplan (MPO) n’est plus prise en charge sur le VidPnSourceId spécifié.
Syntaxe
DXGKCB_MULTIPLANEOVERLAYDISABLED DxgkcbMultiplaneoverlaydisabled;
void DxgkcbMultiplaneoverlaydisabled(
[in] IN_CONST_HANDLE hAdapter,
[in] UINT VidPnSourceId
)
{...}
Paramètres
[in] hAdapter
Gérez l’adaptateur sur lequel la configuration matérielle MPO actuelle n’est plus prise en charge.
[in] VidPnSourceId
VidPnSourceId sur lequel la configuration matérielle MPO actuelle n’est plus prise en charge.
Valeur de retour
None
Remarques
DXGKCB_MULTIPLANEOVERLAYDISABLED avertit le Gestionnaire Windows de bureau (DWM) que la configuration MPO actuelle n’est plus prise en charge, ce qui permet au DWM de revenir à la composition.
Cette demande est traitée de manière asynchrone et peut être retardée par plusieurs trames. Il est recommandé d’appeler cette fonction uniquement dans des cas exceptionnels tels que les scénarios suivants :
Un changement d’affichage ou un événement de prise à chaud sur une sortie ne permet plus de continuer à prendre en charge une configuration MPO validée sur un autre moniteur. Dans ce cas, le pilote peut désactiver les plans de superposition sur le moniteur. L’utilisateur verra un artefact visible, mais il doit être corrigé par le DWM.
Le MPO doit être désactivé en raison de problèmes thermiques. Dans ce cas, le pilote n’a pas besoin de désactiver immédiatement MPO, mais peut attendre que le DWM reçoive la notification et nécessite la prise en charge du MPO (ce que le KMD doit indiquer n’est pas pris en charge en raison du problème thermique). À ce moment-là, le DWM désactive MPO et commence à composer.
Dans les cas classiques, les pilotes doivent plutôt empêcher les configurations de superposition multiplan incompatibles en répondant correctement à DxgkDdiCheckMultiplaneOverlaySupport3.
DXGKCB_XXX fonctions sont implémentées par Dxgkrnl. Pour utiliser cette fonction de rappel, appelez DxgkCbMultiPlaneOverlayDisabled via le DXGKRNL_INTERFACE.
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Windows 10, version 1607 (WDDM 2.1) |
Plateforme cible | Windows |
En-tête | d3dkmddi.h |
IRQL | <= PASSIVE_LEVEL |