DXGKDDI_POSTMULTIPLANEOVERLAYPRESENT fonction de rappel (d3dkmddi.h)

Appelé après l’application d’une nouvelle configuration de superposition multiplan, ce qui permet au pilote d’optimiser l’état du matériel. Facultatif pour les pilotes Windows Display Driver Model (WDDM) 2.0 ou version ultérieure qui prennent en charge les superpositions multiplan.

Syntaxe

DXGKDDI_POSTMULTIPLANEOVERLAYPRESENT DxgkddiPostmultiplaneoverlaypresent;

NTSTATUS DxgkddiPostmultiplaneoverlaypresent(
  IN_CONST_HANDLE hAdapter,
  IN_CONST_PDXGKARG_POSTMULTIPLANEOVERLAYPRESENT pPostPresent
)
{...}

Paramètres

hAdapter

Identifie l’adaptateur contenant le matériel de superposition.

pPostPresent

Pointeur vers une structure DXGKARG_POSTMULTIPLANEOVERLAYPRESENT qui décrit la nouvelle configuration de superposition récemment validée.

Valeur retournée

DXGKDDI_POSTMULTIPLANEOVERLAYPRESENT retourne les valeurs suivantes :

Remarques

Cette fonction est appelée à partir du niveau PASSIF.

Cette fonction est appelée uniquement lorsque le pilote définit PostPresentNeededed de DXGKCB_NOTIFY_MPO_VSYNC_FLAGS membre de la structure DXGKARGCB_NOTIFY_INTERRUPT_DATA dans le rappel VSYNC.

Le pilote peut utiliser cette fonction pour réduire les niveaux de tension, les horloges, les profondeurs FIFO ou toute autre optimisation qui peut économiser de l’énergie.

Le pilote ne doit pas consacrer beaucoup de temps à cet appel, car l’appel bloque le main thread du planificateur GPU et le retard peut entraîner des problèmes présents. Les actions nécessitant beaucoup de temps doivent être mises en file d’attente en tant qu’éléments de travail distincts par pilote et gérées en arrière-plan. Dans ce scénario, tous les conflits entre l’élément mis en file d’attente et les modifications matérielles demandées par les futurs appels pré/post doivent être gérés par le pilote.

Configuration requise