DXGKDDI_POSTMULTIPLANEOVERLAYPRESENT fonction de rappel (d3dkmddi.h)

Article
02/06/2025

Appelé après qu’une nouvelle configuration de superposition multiplan a pris effet, ce qui permet au pilote d’optimiser l’état du matériel. Facultatif pour les pilotes WDDM (Windows Display Driver Model) 2.0 ou ultérieur 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 de retour

DXGKDDI_POSTMULTIPLANEOVERLAYPRESENT retourne les valeurs suivantes :

Retourner le code	Description
STATUS_SUCCESS	Si la routine a été correctement terminée. Le pilote doit toujours retourner un code de réussite. Les échecs entraînent une vérification de bogue.

Remarques

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

Cette fonction est appelée uniquement lorsque le pilote définit PostPresentNeeded 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 passer beaucoup de temps dans cet appel, car l’appel bloque le thread du planificateur GPU principal et le retard peut entraîner des problèmes. 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 avant/post doivent être gérés par le pilote.

Exigences

Exigence	Valeur
plateforme cible	Windows
d’en-tête	d3dkmddi.h

Partager via