Funzione AtaPortInitializeQueueTag (irb.h)

Articolo
02/07/2025

La routine AtaPortInitializeQueueTag inizializza l'elenco di tag della coda per il dispositivo specificato.

Nota I modelli di driver di porta ATA e miniport ATA potrebbero essere modificati o non disponibili in futuro. È invece consigliabile usare driver Storport e modelli di driver miniport Storport.

Sintassi

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

Parametri

DeviceExtension

Puntatore all'estensione del canale.

[in] TargetId

Specifica l'identificatore di destinazione del dispositivo.

[in] Lun

Specifica il numero di unità logica (LUN) del dispositivo.

[in] MaxQueueTag

Specifica il valore massimo consentito per il tag della coda.

Valore restituito

ataPortInitializeQueueTag restituisce true se l'operazione ha esito positivo. In caso contrario, restituisce FALSE.

Osservazioni

Il driver miniport deve chiamare AtaPortInitializeQueueTag prima di usare AtaPortAllocateQueueTag e AtaPortReleaseQueueTag rispettivamente per allocare e rilasciare i tag della coda.

I valori nei parametri TargetId e Lun specificano il dispositivo a cui appartiene il tag della coda. Per generare tag di coda specifici del canale, il driver miniport deve impostare i parametri TargetId e Lun su IDE_UNTAGGED.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Desktop
intestazione	irb.h (include Ata.h, Irb.h)
libreria	Ataport.lib; Pciidex.lib

Vedere anche

AtaPortAllocateQueueTag

AtaPortReleaseQueueTag

Condividi tramite