Fonction AtaPortGetDeviceBase (irb.h)

Article
02/26/2024

La routine AtaPortGetDeviceBase retourne une adresse de base logique mappée utilisée pour communiquer avec un adaptateur HBA.

Note Les modèles de pilote de port ATA et de pilote miniport ATA peuvent être modifiés ou indisponibles à l’avenir. Au lieu de cela, nous vous recommandons d’utiliser les modèles de pilote Storport et de pilote Miniport Storport .

Syntaxe

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

Paramètres

[in] ChannelExtension

Pointeur vers l’extension de canal.

[in] IoAddress

Spécifie l’adresse de base à mapper.

[in] NumberOfBytes

Spécifie la taille, en octets, de la plage que les mappages doivent couvrir. La valeur de ce paramètre peut être obtenue à partir du membre IdeAccessRange de la structure IDE_MINIPORT_RESOURCES .

Valeur retournée

AtaPortGetDeviceBase retourne une adresse de base logique mappée si l’opération réussit. Dans le cas contraire, elle retourne LA VALEUR NULL.

Remarques

Les pilotes miniport doivent utiliser des adresses logiques qui ont été mappées dans l’espace système par AtaPortGetDeviceBase au lieu d’adresses relatives au bus pour communiquer avec son adaptateur HBA. Appels à l’AtaPort... Les routines Port/RegisterXxx nécessitent des adresses logiques mappées.