AtaPortRequestPowerStateChange function (irb.h)

Article
02/22/2024

The AtaPortRequestPowerStateChange routine requests a power state transition for the indicated device.

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.

Syntax

void AtaPortRequestPowerStateChange(
  PVOID           ChannelExtension,
  UCHAR           TargetId,
  UCHAR           Lun,
  IDE_POWER_STATE DesiredPowerState
);

Parameters

ChannelExtension

A pointer to the channel extension.

TargetId

Specifies the target identifier of the device.

Lun

Specifies the logical unit number (LUN).

DesiredPowerState

Contains an enumerator value of type IDE_POWER_STATE that indicates the power state to which the indicated device should be changed.

Return value

None

Remarks

The AtaPortRequestPowerStateChange routine is used when a miniport driver might have to initiate a power state change, such as when a hot-plug operation occurs.

Note The practice of doing idle detection from an ATA miniport driver is discouraged.

Requirements

Requirement	Value
Target Platform	Desktop
Header	irb.h (include Ata.h, Irb.h)