AtaPortInitializeQueueTag, fonction (irb.h)

Article
02/07/2025

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

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

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 de retour

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 balises de file d’attente spécifiques au canal, le pilote miniport doit définir les paramètres TargetId et Lun sur IDE_UNTAGGED.

Exigences

Exigence	Valeur
plateforme cible	Bureau
d’en-tête	irb.h (include Ata.h, Irb.h)
bibliothèque	Ataport.lib ; Pciidex.lib

Voir aussi

AtaPortAllocateQueueTag

AtaPortReleaseQueueTag

Partager via