PDXGK_FSTATE_NOTIFICATION fonction de rappel (d3dkmthk.h)

Article
02/23/2024

Implémenté par le pilote client pour émettre une notification d’état.

Syntaxe

PDXGK_FSTATE_NOTIFICATION PdxgkFstateNotification;

void PdxgkFstateNotification(
  PVOID GraphicsDeviceHandle,
  ULONG ComponentIndex,
  UINT NewFState,
  BOOLEAN PreNotification,
  PVOID PrivateHandle
)
{...}

Paramètres

GraphicsDeviceHandle

Un handle opaque qui doit être fourni lors des rappels vers le périphérique graphique.

ComponentIndex

Index du composant. En règle générale, il s’agit de l’index utilisé par la carte graphique. L’exception concerne les scénarios LDA, où la valeur HIWORD de ComponentIndex indique l’index de l’adaptateur, comme c’est le cas lorsque le pilote graphique est appelé par le noyau graphique pour les modifications d’état F dans les scénarios LDA.

NewFState

État F vers lequel effectuer la transition.

PreNotification

Indique qu’une notification doit être fournie.

PrivateHandle

Handle opaque qui sera fourni dans tous les rappels. Ce handle doit être globalement unique. Par conséquent, un pointeur vers l’AOP ou le FDO du pilote appelant doit être utilisé.

Valeur de retour

None

Remarques

Tous les rappels effectués à partir de Dxgkrnl vers ce rappel peuvent être appelés jusqu’à DISPATCH_LEVEL (par exemple, le pilote non graphique ne doit pas bloquer sur l’une de ces notifications). Les rappels sont effectués uniquement pour les composants d’alimentation de type DXGK_POWER_COMPONENT_SHARED .

Les pré-notifications seront fournies avant la transition des états F. Les rappels de notification d’achèvement (PreNotification==FALSE) sont émis dans le cadre du rappel DxgkCbCompleteFStateTransition du pilote graphique. Autrement dit, tous les composants d’alimentation partagés sont avertis de l’achèvement de la transition de l’état F avant le retour de DxgkCbCompleteFStateTransition.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8
Serveur minimal pris en charge	Windows Server 2012
En-tête	d3dkmthk.h
IRQL	<= DISPATCH_LEVEL

Partager via