AtaPortGetDeviceBase - NtDoc

Native API online documentation, based on the System Informer (formerly Process Hacker) phnt headers
// irb.h

PVOID AtaPortGetDeviceBase(
  [in] PVOID                ChannelExtension,
  [in] IDE_PHYSICAL_ADDRESS IoAddress,
  [in] ULONG                NumberOfBytes
);
View the official Windows Driver Kit DDI reference

NtDoc

No description available.

Windows Driver Kit DDI reference (nf-irb-ataportgetdevicebase)

AtaPortGetDeviceBase function

Description

The AtaPortGetDeviceBase routine returns a mapped logical base address that is used to communicate with an HBA.

Note The ATA port driver and ATA miniport driver models may be altered or unavailable in the future. Instead, we recommend using the Storport driver and Storport miniport driver models.

Parameters

ChannelExtension [in]

A pointer to the channel extension.

IoAddress [in]

Specifies the base address to map.

NumberOfBytes [in]

Specifies the size, in bytes, of the range that the mappings should cover. The value for this parameter can be obtained from the IdeAccessRange member of the IDE_MINIPORT_RESOURCES structure.

Return value

AtaPortGetDeviceBase returns a mapped logical base address if the operation succeeds. Otherwise, it returns NULL.

Remarks

Miniport drivers must use logical addresses that have been mapped into system space by AtaPortGetDeviceBase instead of bus-relative addresses to communicate with its HBA. Calls to the AtaPort...Port/RegisterXxx routines require mapped logical addresses.

See also

AtaPortReadPortUchar

AtaPortReadPortUlong

AtaPortReadPortUshort