AtaPortAllocateQueueTag function (irb.h)

Article
02/22/2024

The AtaPortAllocateQueueTag routine returns a queue tag 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

UCHAR AtaPortAllocateQueueTag(
       PVOID DeviceExtension,
  [in] UCHAR TargetId,
  [in] UCHAR Lun
);

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.

Return value

AtaPortAllocateQueueTag returns a valid queue tag if one can be allocated. A value of 0 is returned if a queue tag could not be allocated.

Remarks

The AtaPortAllocateQueueTag routine allocates either a per device queue tag or a per channel queue tag. To generate a per channel queue tag, 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)