EVT_ACX_FACTORY_CIRCUIT_PREPARE_HARDWARE função de retorno de chamada (acxcircuit.h)
O retorno de chamada EVT_ACX_FACTORY_CIRCUIT_PREPARE_HARDWARE é usado pelo driver para adicionar funcionalidade quando uma fábrica de circuitos está na fase de hardware de preparação.
Sintaxe
EVT_ACX_FACTORY_CIRCUIT_PREPARE_HARDWARE EvtAcxFactoryCircuitPrepareHardware;
NTSTATUS EvtAcxFactoryCircuitPrepareHardware(
WDFDEVICE Device,
ACXFACTORYCIRCUIT Factory,
WDFCMRESLIST ResourcesRaw,
WDFCMRESLIST ResourcesTranslated
)
{...}
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.
ResourcesRaw
Uma lista de recursos do WDF que descreve os recursos brutos a serem usados para a fase de preparação do hardware. Este é 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 recursos brutos, consulte Recursos de Hardware para drivers Framework-Based.
ResourcesTranslated
Uma lista de recursos do WDF que descreve os recursos traduzidos a serem usados para a fase de hardware de preparação. Este é 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 traduzidas, consulte recursos brutos e traduzidos.
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.
Observações
Para registrar uma função de retorno de chamada EvtAcxFactoryCircuitPrepareHardware, um driver deve chamar o método AcxFactoryCircuitInitSetAcxCircuitPnpPowerCallbacks.
Se o driver tiver registrado uma função de retorno de chamada EvtAcxFactoryCircuitPrepareHardware para um ACXFACTORYCIRCUIT, a estrutura ACX chamará a função depois que a estrutura do WDF chamar a função de retorno de chamada EvtDevicePrepareHardware do driver.
A função de retorno de chamada EvtAcxFactoryCircuitPrepareHardware acessa os recursos de hardware brutos e traduzidos do dispositivo usando os identificadores ResourcesRaw e ResourcesTranslated recebidos. A função de retorno de chamada pode chamar WdfCmResourceListGetCount e WdfCmResourceListGetDescriptor para percorrer as listas de recursos. Essa função de retorno de chamada não pode modificar as listas de recursos.
Para obter mais informações sobre listas de recursos e a ordem em que os recursos aparecem, consulte recursos brutos e traduzidos.
Normalmente, a função de retorno de chamada EvtAcxFactoryCircuitPrepareHardware do driver faz o seguinte, se necessário:
- Mapeia endereços de memória física para endereços virtuais do ACXFACTORYCIRCUIT para que o driver possa acessar a memória atribuída ao dispositivo.
- Opcionalmente, a função de retorno de chamada EvtAcxFactoryCircuitPrepareHardware do driver pode enfileirar um item de trabalho para concluir outras tarefas de configuração com uso intensivo de tempo. Usar um item de trabalho para essas operações pode ajudar a garantir que o tempo de inicialização do dispositivo não aumente o tempo de inicialização do sistema. Para obter mais informações, consulte Usando itens de trabalho da estrutura.
- Normalmente, todas as outras operações de inicialização de hardware, incluindo o carregamento de firmware, devem ocorrer sempre que o dispositivo entra em seu estado de trabalho (D0) e, portanto, deve ocorrer na função de retorno de chamada EvtDeviceD0Entry do driver.
A função de retorno de chamada ResourcesRaw e ResourcesTranslated que a função de retorno de chamada EvtAcxCircuitPrepareHardware/EvtDevicePrepareHardware recebe permanece válida até que a função de retorno de chamada EvtDeviceReleaseHardware do driver retorne.
Se o driver falhar no retorno de chamada EvtAcxFactoryCircuitPrepareHardware, o objeto ACXFACTORYCIRCUIT será colocado no estado de exclusão pendente.
Para obter mais informações sobre recursos de hardware, consulte Introdução aos recursos de hardware.
Para obter mais informações sobre quando a estrutura ACX e WDF chamam essas funções de retorno de chamada, consulte cenários de PnP e gerenciamento de energia.
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.
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 |