função de retorno de chamada EVT_ACX_FACTORY_CIRCUIT_RELEASE_HARDWARE (acxcircuit.h)
O retorno de chamada EVT_ACX_FACTORY_CIRCUIT_RELEASE_HARDWARE é usado pelo driver para adicionar funcionalidade quando um ACXFACTORYCIRCUIT está na fase de hardware de lançamento.
Sintaxe
EVT_ACX_FACTORY_CIRCUIT_RELEASE_HARDWARE EvtAcxFactoryCircuitReleaseHardware;
NTSTATUS EvtAcxFactoryCircuitReleaseHardware(
WDFDEVICE Device,
ACXFACTORYCIRCUIT Factory,
WDFCMRESLIST ResourcesTranslated
)
{...}
Parâmetros
Device
Um objeto WDFDEVICE (descrito em Resumo de Objetos framework) 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.
ResourcesTranslated
Uma lista de recursos do WDF que descreve os recursos traduzidos a serem usados para a fase de preparação do hardware. Esse é um objeto de lista de recursos da estrutura WDF que representa uma lista de recursos de hardware para um dispositivo. Para obter mais informações sobre listas de recursos traduzidos, consulte Recursos brutos e traduzidos.
Retornar valor
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.
Comentários
Para registrar uma função de retorno de chamada EvtAcxFactoryCircuitReleaseHardware, seu driver deve chamar AcxFactoryCircuitInitSetAcxCircuitPnpPowerCallbacks.
Se um driver tiver registrado uma função de retorno de chamada EvtAcxFactoryCircuitReleaseHardware, a estrutura a chamará durante as seguintes transições:
- Rebalanceamento de recursos
- Remoção ordenada
- Remoção surpresa
A estrutura ACX chama a função de retorno de chamada EvtAcxFactoryCircuitReleaseHardware depois que a estrutura do WDF parou de enviar solicitações de E/S para o dispositivo, todas as interrupções atribuídas ao dispositivo foram desabilitadas e desconectadas e o dispositivo foi desativado.
A estrutura ACX chama a função de retorno de chamada EvtAcxFactoryCircuitReleaseHardware antes que a estrutura do WDF chame a função de retorno de chamada EvtDeviceReleaseHardware do driver.
Quando a estrutura chama o EvtAcxFactoryCircuitReleaseHardware, o PDO para o dispositivo ainda existe e pode ser consultado quanto a informações de dispositivo disponíveis no estado desligado, por exemplo, estado de configuração PCI.
Além disso, os recursos de hardware traduzidos que a estrutura fornece para EvtDeviceReleaseHardware ainda são atribuídos ao dispositivo. A principal finalidade dessa função de retorno de chamada é liberar esses recursos e, em particular, cancelar o mapeamento de todos os recursos de memória mapeados pela função de retorno de chamada EvtAcxCircuitPrepareHardware do driver. O driver também pode usar esse retorno de chamada para executar qualquer outra atividade de gerenciamento ACXCIRCUIT que possa ser necessária no estado de desligar. Normalmente, todas as outras operações de desligamento de hardware devem ocorrer na função de retorno de chamada EvtDeviceD0Exit do driver.
A estrutura ACX sempre chama a função de retorno de chamada EvtAcxFactoryCircuitReleaseHardware do driver se a função de retorno de chamada EvtAcxFactoryCircuitPrepareHardware do driver tiver sido chamada, a menos que a função de retorno de chamada EvtAcxFactoryCircuitPrepareHardware tenha retornado um código de falha.
Para obter mais informações sobre quando a estrutura ACX e WDF chamam essas funções de retorno de chamada, consulte Cenários de gerenciamento de energia e PnP.
Para obter mais informações sobre recursos de hardware, consulte Introdução aos recursos de hardware.
Para obter mais informações sobre drivers que fornecem essa função de retorno de chamada, consulte Suporte a PnP e Gerenciamento de Energia no Driver de Funções.
Requisitos do ACX
Versão mínima do ACX: 1.0
Para obter mais informações sobre as versões do ACX, consulte Visão geral da versão do ACX.
Requisitos
| Requisito | Valor |
|---|---|
| Cabeçalho | acxcircuit.h |
| IRQL | PASSIVE_LEVEL |