Función AtaPortInitializeQueueTag (irb.h)

La rutina AtaPortInitializeQueueTag inicializa la lista de etiquetas de cola para el dispositivo especificado.

Nota Los modelos de controlador de puerto ATA y controlador de minipuerto de ATA pueden modificarse o no estar disponibles en el futuro. En su lugar, se recomienda usar el controlador Storport y los modelos de controlador de miniport storport .

 

Sintaxis

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

Parámetros

DeviceExtension

Puntero a la extensión del canal.

[in] TargetId

Especifica el identificador de destino del dispositivo.

[in] Lun

Especifica el número de unidad lógica (LUN) del dispositivo.

[in] MaxQueueTag

Especifica el valor máximo permitido para la etiqueta de cola.

Valor devuelto

AtaPortInitializeQueueTag devuelve TRUE si la operación se realiza correctamente. De lo contrario, devuelve FALSE.

Comentarios

El controlador de miniport debe llamar a AtaPortInitializeQueueTag antes de usar AtaPortAllocateQueueTag y AtaPortReleaseQueueTag para asignar y liberar etiquetas de cola respectivamente.

Los valores de los parámetros TargetId y Lun especifican el dispositivo al que pertenece la etiqueta de cola. Para generar etiquetas de cola específicas del canal, el controlador de minipuerto debe establecer los parámetros TargetId y Lun en IDE_UNTAGGED.

Requisitos

Requisito	Value
Plataforma de destino	Escritorio
Encabezado	irb.h (incluya Ata.h, Irb.h)
Library	Ataport.lib; Pciidex.lib

Consulte también

AtaPortAllocateQueueTag

AtaPortReleaseQueueTag