Share via

EVT_ACX_FACTORY_CIRCUIT_PREPARE_HARDWARE função de retorno de chamada (acxcircuit.h)

  • Artigo

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 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.

ResourcesRaw

Uma lista de recursos do WDF que descreve os recursos brutos 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 recursos brutos, consulte Recursos de hardware para drivers de Framework-Based.

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 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 após 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 que ele recebe. 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. O uso de 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 entrar 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 gerenciamento de energia e PnP.

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

Confira também