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

La rutina del controlador de miniporte IdeHwInitialize configura el dispositivo indicado.

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_HW_INITIALIZE IdeHwInitialize;

BOOLEAN IdeHwInitialize(
  [in]      PVOID ChannelExtension,
  [in, out] PIDE_DEVICE_PARAMETERS DeviceParameters,
  [in]      PIDENTIFY_DEVICE_DATA IdentifyData
)
{...}

Parámetros

[in] ChannelExtension

Puntero al controlador de minipuerto por extensión de dispositivo de canal.

[in, out] DeviceParameters

Puntero a una estructura de tipo IDE_DEVICE_PARAMETERS que identifica el dispositivo para configurar y los parámetros del dispositivo con los que configurar el dispositivo.

[in] IdentifyData

Puntero a una estructura de tipo IDENTIFY_DEVICE_DATA que contiene los datos de identificación devueltos por el dispositivo.

Valor devuelto

IdeHwInitialize devuelve TRUE si la operación se realiza correctamente. Devuelve FALSE si se produce un error en la operación.

Comentarios

Después de que el controlador de miniporte enumera los dispositivos de un canal, llama a la rutina IdeHwInitialize una vez para cada dispositivo que enumera. La rutina IdeHwInitialize debe configurar cada dispositivo en función de la información especificada en la estructura IDE_DEVICE_PARAMETERS , a la que apunta el parámetro DeviceParameters . En casos excepcionales, el controlador de minipuerto puede configurar el dispositivo mediante un conjunto de parámetros que difieren de los contenidos en IDE_DEVICE_PARAMETERS. En tales casos, el controlador de minipuerto debe actualizar la información de IDE_DEVICE_PARAMETERS para contener el valor del parámetro que realmente usó para configurar el dispositivo. Después de que se devuelva la rutina IdeHwInitialize , el controlador de puerto actualiza su información almacenada en caché con los valores de parámetro proporcionados por el controlador de minipuerto.

Requisitos

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

Consulte también

IDENTIFY_DEVICE_DATA

IDE_DEVICE_PARAMETERS