AtaPortInitializeQueueTag function (irb.h)

The AtaPortInitializeQueueTag routine initializes the queue tag list for the specified 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

BOOLEAN AtaPortInitializeQueueTag(
       PVOID DeviceExtension,
  [in] UCHAR TargetId,
  [in] UCHAR Lun,
  [in] UCHAR MaxQueueTag
);

Parameters

DeviceExtension

A pointer to the channel extension.

[in] TargetId

Specifies the target identifier of the device.

[in] Lun

Specifies the logical unit number (LUN) of the device.

[in] MaxQueueTag

Specifies the maximum allowed value for the queue tag.

Return value

AtaPortInitializeQueueTag returns TRUE if the operation succeeds. Otherwise, it returns FALSE.

Remarks

The miniport driver should call AtaPortInitializeQueueTag before it uses AtaPortAllocateQueueTag and AtaPortReleaseQueueTag to allocate and release queue tags respectively.

The values in the TargetId and Lun parameters specify the device to which the queue tag belongs. To generate channel specific queue tags, the miniport driver should set the TargetId and Lun parameters to IDE_UNTAGGED.

Requirements

Requirement	Value
Target Platform	Desktop
Header	irb.h (include Ata.h, Irb.h)
Library	Ataport.lib; Pciidex.lib

See also

AtaPortAllocateQueueTag

AtaPortReleaseQueueTag