Fonction AtaPortInitializeQueueTag (irb.h)

Article
02/29/2024

La routine AtaPortInitializeQueueTag initialise la liste d’étiquettes de file d’attente pour l’appareil spécifié.

Note Les modèles de pilote de port ATA et de pilote miniport ATA peuvent être modifiés ou indisponibles à l’avenir. Au lieu de cela, nous vous recommandons d’utiliser les modèles de pilote Storport et de pilote miniport Storport .

Syntaxe

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

Paramètres

DeviceExtension

Pointeur vers l’extension de canal.

[in] TargetId

Spécifie l’identificateur cible de l’appareil.

[in] Lun

Spécifie le numéro d’unité logique (LUN) de l’appareil.

[in] MaxQueueTag

Spécifie la valeur maximale autorisée pour la balise de file d’attente.

Valeur retournée

AtaPortInitializeQueueTag retourne TRUE si l’opération réussit. Sinon, elle retourne FALSE.

Remarques

Le pilote miniport doit appeler AtaPortInitializeQueueTag avant d’utiliser AtaPortAllocateQueueTag et AtaPortReleaseQueueTag pour allouer et libérer des balises de file d’attente respectivement.

Les valeurs des paramètres TargetId et Lun spécifient l’appareil auquel appartient la balise de file d’attente. Pour générer des étiquettes de file d’attente spécifiques au canal, le pilote miniport doit définir les paramètres TargetId et Lun sur IDE_UNTAGGED.

Configuration requise

Condition requise	Valeur
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	irb.h (inclure Ata.h, Irb.h)
Bibliothèque	Ataport.lib ; Pciidex.lib

Voir aussi

AtaPortAllocateQueueTag

AtaPortReleaseQueueTag

Partager via