Função AtaPortInitializeEx (irb.h)

Artigo
08/07/2023

A rotina de biblioteca de driver de porta ATA ATA AtaPortInitializeEx inicializa os drivers de porta e de miniport.

Nota O driver de porta do ATA e os modelos de driver de miniporta do ATA podem ser alterados ou indisponíveis no futuro. Em vez disso, recomendamos usar os modelos de driver storport e driver de miniporto Storport .

Sintaxe

ULONG AtaPortInitializeEx(
  [in] PVOID                     DriverObject,
  [in] PVOID                     RegistryPath,
  [in] PIDE_CONTROLLER_INTERFACE ControllerInterface
);

Parâmetros

[in] DriverObject

Um ponteiro para o objeto de driver de miniport.

[in] RegistryPath

Contém uma cadeia de caracteres Unicode que indica o local no registro em que as informações de configuração do driver de miniporto são armazenadas.

[in] ControllerInterface

Contém os pontos de entrada para as rotinas AtaAdapterControl, AtaChannelInitRoutine, AtaControllerChannelEnabled e AtaControllerTransferModeSelect .

Retornar valor

AtaPortInitializeEx retornará STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, ele retornará um código de erro.

Comentários

A rotina AtaPortInitializeEx inicializa as principais estruturas de dados usadas pelos drivers de porta e miniport. Ele também inicia a inicialização dos canais do controlador. A sequência a seguir descreve as principais ações executadas por essa rotina:

Enquanto estiver em sua rotina DriverEntry , o driver de miniporto chama a rotina de biblioteca AtaPortInitializeEx do driver de porta e passa os seguintes parâmetros principais:
- ControllerInterface: contém os pontos de entrada para as rotinas AtaAdapterControl, AtaChannelInitRoutine, AtaControllerChannelEnabled e AtaControllerTransferModeSelect .
A rotina AtaPortInitializeEx inicializa as principais estruturas de dados usadas pelos drivers de porta e miniport e executa as seguintes ações:
1. Inicializa as tabelas de expedição do driver de miniport.
2. Aloca uma extensão para o objeto de driver.
3. Copia ControllerInterface para a extensão de driver.
4. Depois que AtaPortInitializeEx concluir a inicialização do driver de porta, ele retornará à rotina DriverEntry do driver de miniport.
Ao iniciar o dispositivo adaptador, a rotina do driver de miniporta AtaAdapterControl será chamada pelo driver de porta com a ação de controle IdeStart.
Quando o driver de porta do ATA está processando uma solicitação de início de dispositivo de canal, a rotina do driver de miniporta AtaControllerChannelEnabled é chamada para cada canal no controlador para determinar se ele está habilitado.
Depois que a rotina AtaControllerChannelEnabled determina quais canais estão habilitados, o driver de porta do ATA chama AtaChannelInitRoutine para esse canal.