Compartilhar via


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

Implementado pelo driver do 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 gráfico é chamado pelo kernel de gráficos 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 quaisquer retornos de chamada. Esse identificador deve ser globalmente exclusivo, portanto, um ponteiro para o PDO ou FDO do driver de chamada deve ser usado.

Retornar valor

Nenhum

Comentários

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

As pré-notificações serão fornecidas antes da transição dos estados F. Os retornos de chamada de notificação de conclusão (PreNotification==FALSE) são emitidos como parte do retorno de chamada DxgkCbCompleteFStateTransition do driver gráfico. 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
Cliente mínimo com suporte Windows 8
Servidor mínimo com suporte Windows Server 2012
Cabeçalho d3dkmthk.h
IRQL <= DISPATCH_LEVEL