EVT_ACX_FACTORY_CIRCUIT_POWER_UP função de retorno de chamada (acxcircuit.h)
O retorno de chamada EVT_ACX_FACTORY_CIRCUIT_POWER_UP é usado pelo driver para adicionar funcionalidade no caminho de energia de um objeto ACXFACTORYCIRCUIT.
Sintaxe
EVT_ACX_FACTORY_CIRCUIT_POWER_UP EvtAcxFactoryCircuitPowerUp;
NTSTATUS EvtAcxFactoryCircuitPowerUp(
WDFDEVICE Device,
ACXFACTORYCIRCUIT Factory,
WDF_POWER_DEVICE_STATE PreviousState
)
{...}
Parâmetros
Device
Um objeto WDFDEVICE (descrito em Resumo de Objetos da Estrutura) associado ao circuito ACX.
Factory
O objeto ACXFACTORYCIRCUIT da fábrica de circuitos existente. Para obter mais informações sobre objetos ACX, consulte Resumo de objetos ACX.
PreviousState
Uma enumeração WDF_POWER_DEVICE_STATE que identifica o estado de energia do dispositivo anterior.
Valor de retorno
Retorna STATUS_SUCCESS se a chamada foi bem-sucedida. Caso contrário, ele retornará um código de erro apropriado. Para obter mais informações, consulte Usando valores NTSTATUS.
Se o driver falhar nesse retorno de chamada, ele marcará o ACXFACTORYCIRCUIT como exclusão pendente. A estrutura ACX não falha no retorno de chamada ACX EvtDeviceD0Entry sublinhado, permitindo que acXFACTORYCIRCUITs de trabalho existentes desse dispositivo sejam usados para criar caminhos de áudio em funcionamento.
Observações
Para registrar uma função de retorno de chamada EvtFactoryCircuitPowerUp, um driver deve chamar AcxFactoryCircuitInitSetAcxCircuitPnpPowerCallbacks.
Se o driver tiver registrado uma função de retorno de chamada EvtFactoryCircuitPowerUp para um dispositivo, a estrutura chamará a função sempre que o dispositivo entrar em seu estado de trabalho (D0). Um dispositivo entrará no estado D0 quando ocorrer um destes procedimentos:
- Um dispositivo é enumerado (porque o dispositivo foi conectado ou o sistema foi reinicializado).
- O sistema e todos os seus dispositivos retornam aos seus estados de trabalho de um estado de baixa potência.
- O dispositivo retorna ao seu estado de trabalho depois que inseriu um estado de baixa potência porque estava ocioso (se o dispositivo dá suporte a ociosidade de baixa potência).
- O Gerenciador de Plug and Play redistribuiu os recursos de hardware do sistema entre os dispositivos do sistema.
- A estrutura chama a função de retorno de chamada EvtDeviceD0Entry imediatamente após o dispositivo entrar em seu estado de trabalho (D0) e estiver disponível para o driver, mas antes que as interrupções do dispositivo tenham sido habilitadas. O parâmetro PreviousState identifica o estado de energia do dispositivo em que o dispositivo estava antes de entrar no estado D0. Quando a estrutura chama EvtDeviceD0Entry pela primeira vez, ela fornece um valor PreviousState de WdfPowerDeviceD3Final.
Essa função de retorno de chamada deve executar todas as operações necessárias para tornar o dispositivo totalmente operacional.
Para obter mais informações sobre drivers que fornecem essa função de retorno de chamada, consulte Suporte ao PnP e ao Gerenciamento de Energia nodo Driver de Funções.
A função de retorno de chamada EvtFactoryCircuitPowerUp é chamada em IRQL = PASSIVE_LEVEL. Você não deve tornar essa função de retorno de chamada paginável.
Requisitos do ACX
versão mínima do ACX: 1.0
Para obter mais informações sobre versões do ACX, consulte visão geral da versão do ACX.
Requisitos
| Requisito | Valor |
|---|---|
| cabeçalho | acxcircuit.h |
| IRQL | PASSIVE_LEVEL |