PDXGK_POWER_NOTIFICATION função de retorno de chamada (d3dkmthk.h)
Um retorno de chamada que fornece uma notificação de que o dispositivo gráfico passará por uma transição de estado de energia do dispositivo.
Sintaxe
PDXGK_POWER_NOTIFICATION PdxgkPowerNotification;
void PdxgkPowerNotification(
PVOID GraphicsDeviceHandle,
DEVICE_POWER_STATE NewGrfxPowerState,
BOOLEAN PreNotification,
PVOID PrivateHandle
)
{...}
Parâmetros
GraphicsDeviceHandle
Um identificador opaco que deve ser fornecido ao fazer retornos de chamada para o dispositivo gráfico.
NewGrfxPowerState
Um valor DEVICE_POWER_STATE que indica o novo estado de poder gráfico que está em processo de definição.
PreNotification
Valor booliano que indica se uma notificação deve ser fornecida.
PrivateHandle
Um identificador opaco 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
Esse retorno de chamada é feito em PASSIVE_LEVEL. O driver pode bloquear para concluir a manutenção da operação somente quando o novo estado de energia for PowerDeviceD3. Nesse caso, a chamada ainda deve ser concluída em tempo hábil, pois pode bloquear a conclusão da transição geral do estado de energia do dispositivo e está sujeita a causar um bug de power watchdog marcar. O driver não deve bloquear quando o novo estado é PowerDeviceD0. Ao entrar no PowerDeviceD3, uma notificação "pre" e "post" será fornecida, supondo que a transição não seja cancelada nesse ínterim. Ao entrar no PowerDeviceD0, somente uma notificação de "postagem" será fornecida. É permitido que esse manipulador de retorno de chamada chame o retorno de chamada de elementos gráficos SetSharedPowerComponentStateCb, se desejado; nenhum outro retorno de chamada no kernel de elementos gráficos é permitido desse manipulador.
Importante
No entanto, o estado de energia dos elementos gráficos iniciais será fornecido na saída ioctl, pois é possível que o dispositivo gráfico esteja passando por uma transição de estado de energia enquanto o registro está ocorrendo, um mutex deve ser adquirido em torno da chamada IOCTL e análise do estado original, e esse mesmo mutex deve ser adquirido nessa função de retorno de chamada. Dessa forma, se o estado fizer a transição, o retorno de chamada fornecerá as informações de estado mais atualizadas.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 8 |
| Servidor mínimo com suporte | Windows Server 2012 |
| Plataforma de Destino | Windows |
| Cabeçalho | d3dkmthk.h |
| IRQL | <= PASSIVE_LEVEL |