Função AtaPortInitializeEx (irb.h)

Artigo
02/07/2025

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

Observação o driver de porta do ATA e os modelos de driver de miniporto do ATA podem estar alterados ou indisponíveis no futuro. Em vez disso, recomendamos usar o de driver do Storport e miniporto storport modelos de driver.

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

[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 do AtaAdapterControl, AtaChannelInitRoutine, AtaControllerChannelEnablede rotinas de AtaControllerTransferModeSelect.

Valor de retorno

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

Observações

A rotina AtaPortInitializeEx inicializa as principais estruturas de dados usadas pelos drivers de porta e de miniporto. 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:

Em sua rotina de 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 doAtaAdapterControl, AtaChannelInitRoutine, AtaControllerChannelEnablede rotinas de AtaControllerTransferModeSelect.
A rotina AtaPortInitializeEx inicializa as principais estruturas de dados usadas pelos drivers de porta e de miniporto 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 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 dedriverEntry do miniportor.
Ao iniciar o dispositivo do adaptador, a rotina do driver de miniporto AtaAdapterControl será chamada pelo driver de porta com 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 miniporto AtaControllerChannelEnabled é chamada para cada canal no controlador determinar se ele está habilitado.
Depois que a rotina de AtaControllerChannelEnabled determina quais canais estão habilitados, o driver de porta do ATA chama AtaChannelInitRoutine para este canal.

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	irb.h (include Ata.h, Irb.h)
biblioteca	Pciidex.lib

Consulte também

AtaChannelInitRoutine

AtaControllerChannelEnabled

DriverEntry

IDE_CONTROLLER_CONFIGURATION

Partilhar via