IDE_ADAPTER_CONTROL función de devolución de llamada (irb.h)

  • Artículo

Se llama a la rutina del controlador de miniporte AtaAdapterControl para realizar operaciones de Plug and Play (PnP) y administración de energía en el HBA.

Nota

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

Sintaxis

IDE_ADAPTER_CONTROL IdeAdapterControl;

BOOLEAN IdeAdapterControl(
  [in]      PVOID ControllerExtension,
  [in]      IDE_CONTROL_ACTION ControlAction,
  [in, out] PVOID Parameters
)
{...}

Parámetros

[in] ControllerExtension

Puntero a la extensión del controlador.

[in] ControlAction

Una de las cinco acciones que el controlador de minipuerto debe realizar como se define en la tabla siguiente.

ControlAction Parámetros Descripción
IdeStart IDE_CONTROLLER_CONFIGURATION Indica que se está iniciando el adaptador. El controlador de minipuerto debe actualizar el miembro en la estructura IDE_CONTROLLER_CONFIGURATION . Si es necesario, el controlador de minipuerto podría obtener sus recursos de hardware de la estructura IDE_CONTROLLER_CONFIGURATION .
IdeStop None El controlador de minipuerto debe dejar de usar los recursos asignados para este controlador. Tenga en cuenta que el controlador de puerto garantiza que todos los canales expuestos por el adaptador se detengan antes de que detenga el adaptador.
IdePowerUp None Indica que el adaptador se está activando. Todo lo que no persista en un ciclo de alimentación debe configurarse durante IdePowerUp.
IdePowerDown None Indica que el adaptador se está desactivando.
IdeVendorDefined None Indica que el controlador de minipuerto debe realizar una acción de control definida por el proveedor.

[in, out] Parameters

Parámetros asociados a la acción especificada.

Valor devuelto

El controlador de minipuerto debe devolver TRUE para confirmar la finalización de la acción solicitada. Un valor devuelto de FALSE indica que el controlador de minipuerto no pudo completar correctamente la acción. Un valor devuelto de FALSE para determinadas acciones puede provocar un error en la instalación del dispositivo.

Comentarios

El controlador de puerto garantiza que no hay ninguna E/S pendiente en el adaptador antes de invocar la rutina AtaAdapterControl .

Requisitos

Requisito Value
Plataforma de destino Escritorio
Encabezado irb.h (incluir Irb.h)

Consulte también

IDE_CONTROLLER_CONFIGURATION