Compartir a través de


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

La rutina IdeHwInitialize miniport driver configura el dispositivo indicado.

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

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.

Observaciones

Una vez que el controlador de miniporte enumera los dispositivos de un canal, llama a la IdeHwInitialize rutina 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 de IDE_DEVICE_PARAMETERS, a la que apunta el parámetro DeviceParameters. En casos excepcionales, el controlador de miniporte 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 miniport debe actualizar la información de IDE_DEVICE_PARAMETERS para contener el valor de parámetro que realmente usó para configurar el dispositivo. Después de que se devuelva la rutina deIdeHwInitialize, el controlador de puerto actualiza su información almacenada en caché con los valores de parámetro proporcionados por el controlador de miniport.

Requisitos

Requisito Valor
de la plataforma de destino de Escritorio
encabezado de irb.h (incluya Irb.h)

Consulte también

IDENTIFY_DEVICE_DATA

IDE_DEVICE_PARAMETERS