PDXGK_FSTATE_NOTIFICATION função de retorno de chamada (d3dkmthk.h)

Implementado pelo driver cliente para emitir uma notificação de estado.

Sintaxe

PDXGK_FSTATE_NOTIFICATION PdxgkFstateNotification;

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

Parâmetros

GraphicsDeviceHandle

Um identificador opaco que deve ser fornecido ao fazer retornos de chamada para o dispositivo gráfico.

ComponentIndex

O índice do componente. Em geral, esse será o índice usado pelo adaptador gráfico. A exceção é para cenários LDA, em que o HIWORD do ComponentIndex indica o índice do adaptador, como é feito quando o driver de gráficos é chamado pelo kernel gráfico para alterações de estado F em cenários LDA.

NewFState

O estado F para o qual fazer a transição.

PreNotification

Indica que uma notificação deve ser fornecida.

PrivateHandle

Um identificador opaco que será fornecido em qualquer retorno de chamada. Esse identificador deve ser globalmente exclusivo, portanto, um ponteiro para o PDO ou FDO do driver de chamada deve ser usado.

Valor de retorno

Nenhum

Observações

Todos os retornos de chamada feitos de Dxgkrnl para esse retorno de chamada podem ser chamados até DISPATCH_LEVEL (por exemplo, o driver não gráfico não deve bloquear nenhuma dessas notificações). Os retornos de chamada serão feitos apenas para componentes de energia de tipo DXGK_POWER_COMPONENT_SHARED.

As pré-notificações serão fornecidas antes da transição de estados F. Os retornos de chamada de notificação de conclusão (PreNotification==FALSE) são emitidos como parte do DxgkCbCompleteFStateTransition do driver gráfico retorno de chamada. Ou seja, todos os componentes de energia compartilhados serão notificados sobre a conclusão da transição de estado F antes do retorno de DxgkCbCompleteFStateTransition.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 8
servidor com suporte mínimo	Windows Server 2012
cabeçalho	d3dkmthk.h
IRQL	<= DISPATCH_LEVEL