DXGKCB_MULTIPLANEOVERLAYDISABLED fonction de rappel (d3dkmddi.h)

  • Article

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

Voir aussi

DxgkDdiCheckMultiplaneOverlaySupport3

DXGKRNL_INTERFACE