Edit

Share via

AtaPortRequestPowerStateChange function (irb.h)

  • Article

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)

See also

IDE_POWER_STATE