Compartir a través de

Función AtaPortInitializeEx (irb.h)

  • Artículo

La rutina AtaPortInitializeEx biblioteca de controladores de puerto de ATA inicializa los controladores de puerto y miniport.

Nota Los modelos de controlador de puerto ATA y controlador de miniport ATA pueden modificarse o no estar disponibles en el futuro. En su lugar, se recomienda usar el del controlador storport de y modelos de controlador de storport.
 

Sintaxis

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

Parámetros

[in] DriverObject

Puntero al objeto de controlador de minipuerto.

[in] RegistryPath

Contiene una cadena Unicode que indica la ubicación en el registro donde se almacena la información de configuración del controlador de miniporte.

[in] ControllerInterface

Contiene los puntos de entrada de laAtaAdapterControl de, AtaChannelInitRoutine, AtaControllerChannelEnabledy AtaControllerTransferModeSelect rutinas.

Valor devuelto

AtaPortInitializeEx devuelve STATUS_SUCCESS si la operación se realiza correctamente. De lo contrario, devuelve un código de error.

Observaciones

El AtaPortInitializeEx rutina inicializa las estructuras de datos clave que usan los controladores de puerto y miniport. También inicia la inicialización de los canales del controlador. En la secuencia siguiente se describen las acciones principales realizadas por esta rutina:

  1. Aunque en su rutina de DriverEntry, el controlador de miniporta llama a la rutina de biblioteca de AtaPortInitializeEx del controlador de puerto y la pasa los siguientes parámetros clave:
    • ControllerInterface: contiene los puntos de entrada de laAtaAdapterControl de, AtaChannelInitRoutine, AtaControllerChannelEnabledy AtaControllerTransferModeSelect rutinas.
  2. El AtaPortInitializeEx rutina inicializa las estructuras de datos clave que usan los controladores de puerto y miniport y realiza las siguientes acciones:
    1. Inicializa las tablas de distribución del controlador de miniport.
    2. Asigna una extensión para el objeto de controlador.
    3. Copia ControllerInterface en la extensión del controlador.
    4. Después de AtaPortInitializeEx completa la inicialización del controlador de puerto, vuelve a la rutina del controlador de miniporte DriverEntry.
  3. Al iniciar el dispositivo adaptador, la rutina del controlador de miniporte AtaAdapterControl se llamará mediante el controlador de puerto con la acción de control IdeStart.
  4. Cuando el controlador de puerto de ATA está procesando una solicitud de inicio del dispositivo de canal, se llama a la rutina del controlador de miniporte AtaControllerChannelEnabled para cada canal del controlador para determinar si está habilitado.
  5. Después de rutina de AtaControllerChannelEnabled determina qué canales están habilitados, el controlador de puerto de ATA llama AtaChannelInitRoutine para este canal.

Requisitos

Requisito Valor
de la plataforma de destino de Escritorio
encabezado de irb.h (incluya Ata.h, Irb.h)
biblioteca de Pciidex.lib

Consulte también

AtaChannelInitRoutine

AtaControllerChannelEnabled

DriverEntry de

IDE_CONTROLLER_CONFIGURATION