Función AtaPortGetDeviceBase (irb.h)

Artículo
02/26/2024

La rutina AtaPortGetDeviceBase devuelve una dirección base lógica asignada que se usa para comunicarse con un 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

PVOID AtaPortGetDeviceBase(
  [in] PVOID                ChannelExtension,
  [in] IDE_PHYSICAL_ADDRESS IoAddress,
  [in] ULONG                NumberOfBytes
);

Parámetros

[in] ChannelExtension

Puntero a la extensión de canal.

[in] IoAddress

Especifica la dirección base que se va a asignar.

[in] NumberOfBytes

Especifica el tamaño, en bytes, del intervalo que deben cubrir las asignaciones. El valor de este parámetro se puede obtener del miembro IdeAccessRange de la estructura IDE_MINIPORT_RESOURCES .

Valor devuelto

AtaPortGetDeviceBase devuelve una dirección base lógica asignada si la operación se realiza correctamente. De lo contrario, devuelve NULL.

Comentarios

Los controladores de minipuerto deben usar direcciones lógicas asignadas al espacio del sistema por AtaPortGetDeviceBase en lugar de direcciones relativas a bus para comunicarse con su HBA. Llamadas a AtaPort... Las rutinas Port/RegisterXxx requieren direcciones lógicas asignadas.