PDXGK_FSTATE_NOTIFICATION función de devolución de llamada (d3dkmthk.h)

Implementado por el controlador de cliente para emitir una notificación de estado.

Sintaxis

PDXGK_FSTATE_NOTIFICATION PdxgkFstateNotification;

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

Parámetros

GraphicsDeviceHandle

Identificador opaco que se debe proporcionar al realizar devoluciones de llamada en el dispositivo gráfico.

ComponentIndex

Índice del componente. Por lo general, este será el índice utilizado por el adaptador de gráficos. La excepción es para escenarios de LDA, donde HIWORD del ComponentIndex indica el índice del adaptador, como se hace cuando el kernel de gráficos llama al controlador de gráficos para los cambios de estado F en escenarios de LDA.

NewFState

Estado F al que se va a realizar la transición.

PreNotification

Indica que se debe proporcionar una notificación.

PrivateHandle

Identificador opaco que se proporcionará en las devoluciones de llamada. Este identificador debe ser único globalmente, por lo tanto, se debe usar un puntero al PDO o FDO del controlador que realiza la llamada.

Valor devuelto

None

Observaciones

Todas las devoluciones de llamada realizadas desde Dxgkrnl a esta devolución de llamada se pueden llamar hasta DISPATCH_LEVEL (por ejemplo, el controlador que no es gráfico no debe bloquearse en ninguna de estas notificaciones). Las devoluciones de llamada solo se realizarán para DXGK_POWER_COMPONENT_SHARED componentes de energía de tipo.

Las notificaciones previas se proporcionarán antes de realizar la transición de los estados F. Las devoluciones de llamada de notificación de finalización (PreNotification==FALSE) se emiten como parte de la devolución de llamada DxgkCbCompleteFStateTransition del controlador de gráficos. Es decir, se notificará a todos los componentes de energía compartidos la finalización de la transición de estado F antes de que dxgkCbCompleteFStateTransition devuelva.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8
Servidor mínimo compatible	Windows Server 2012
Encabezado	d3dkmthk.h
IRQL	<= DISPATCH_LEVEL