IOCTL_SCSI_PASS_THROUGH_DIRECT IOCTL (ntddscsi.h)

Ermöglicht einer Anwendung, fast jeden SCSI-Befehl an ein Zielgerät mit den folgenden Einschränkungen zu senden:

• Multitarget-Befehle, z. B. KOPIEREN, sind nicht zulässig.
• Bidirektionale Datenübertragungsvorgänge werden nicht unterstützt.
• Wenn ein Klassentreiber für den Zieltyp des Geräts vorhanden ist, muss die Anforderung an diesen Klassentreiber gesendet werden. Daher kann eine Anwendung diese Anforderung direkt an den Systemporttreiber für eine ziellogische Einheit senden, wenn kein Klassentreiber für den Typ des mit dieser LU verbundenen Geräts vorhanden ist.
• Diese Anforderung muss erfolgen, wenn das Eingabe-CDB möglicherweise den zugrunde liegenden Miniporttreiber für den direkten Zugriff auf den Arbeitsspeicher benötigt.

Die aufrufende Anwendung erstellt den SCSI-Befehlsdeskriptorblock, der eine Anforderung für Anforderungsoptimierungsdaten enthalten kann, wenn eine CHECK CONDITION auftritt. Wenn das CDB einen Datenübertragungsvorgang anfordert, muss der Aufrufer einen Adaptergerät-Ausgerichteten Puffer einrichten, von dem bzw. in den der Miniporttreiber Daten direkt übertragen kann. Diese Anforderung wird in der Regel zum Übertragen größerer Datenmengen (>16K) verwendet.

Anwendungen können diese Anforderung über eine IRP_MJ_DEVICE_CONTROL Anforderung senden.

Speicherklassentreiber legen die Neben-IRP-Nummer auf IRP_MN_SCSI_CLASS fest, um anzugeben, dass die Anforderung von einem Speicherklassentreiber verarbeitet wurde.

Hinweis Der SCSI-Porttreiber und die SCSI-Miniporttreibermodelle können in Zukunft geändert oder nicht mehr verfügbar sein. Stattdessen empfehlen wir die Verwendung des Storport-Treibers und Storport Miniport Treibermodelle.

 

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

Diese Struktur enthält einen SCSI CDB, der vom Aufrufer initialisiert werden muss, mit Ausnahme des Pfads, der Ziel-ID und der LUN, die vom Porttreiber ausgefüllt werden. Bei einem Datenausgangsbefehl müssen sich die zu übertragenden Daten in einem Adaptergerät befinden. Der DataBuffer- Member von SCSI_PASS_THROUGH_DIRECT ist ein Zeiger auf diesen Adaptergerät- ausgerichteter Puffer. Der Aufrufer muss zusätzlichen Speicher nach der SCSI_PASS_THROUGH_DIRECT Struktur zuweisen, wenn der Aufrufer nach Anforderungsoptimierungsdaten fragt.

Eingabepufferlänge

Parameters.DeviceIoControl.InputBufferLength gibt die Größe des Puffers bei Irp->AssociatedIrp.SystemBuffer-an, die mindestens (Sinnes-Datengröße + Größe (SCSI_PASS_THROUGH_DIRECT)) sein muss. Die Größe der SCSI_PASS_THROUGH_DIRECT-Struktur ist fest.

Ausgabepuffer

Der Porttreiber gibt alle Anforderungsoptimierungsdaten und die SCSI_PASS_THROUGH_DIRECT Struktur an den Puffer bei Irp->AssociatedIrp.SystemBufferzurück.

Länge des Ausgabepuffers

SenseInfoLength und DataTransferLength werden aktualisiert, um die Menge der übertragenen Daten anzugeben. Der Porttreiber gibt alle vom Gerät übertragenen Daten an den bereitgestellten zwischengespeicherten Puffer an DataBuffer- zurück.

Statusblock

Das Feld Information wird auf die Anzahl der im Ausgabepuffer zurückgegebenen Bytes bei Irp->AssociatedIrp.SystemBufferfestgelegt. Das Feld "Status" wird auf STATUS_SUCCESSoder möglicherweise auf STATUS_BUFFER_TOO_SMALL oder STATUS_INVALID_PARAMETER festgelegt, wenn der Eingabewert Length wert in SCSI_PASS_THROUGH_DIRECT nicht ordnungsgemäß festgelegt ist oder der in DataBuffer- angegebene Puffer nicht ordnungsgemäß ausgerichtet ist.

Bemerkungen

Bei Datenübertragungsvorgängen ist ein Puffer mit der Ausrichtung des Adaptergeräts erforderlich. Anwendungen können das Geräteausrichtungsformat abrufen, indem sie eine IOCTL_STORAGE_QUERY_PROPERTY Steuerelementcodeanforderung mit einem Abfragetyp von PropertyStandardQuery und Eigenschafts-ID von StorageAdapterPropertyausgibt. Das Ausrichtungsformat befindet sich im AlignmentMask Element der zurückgegebenen STORAGE_ADAPTER_DESCRIPTOR Struktur. Treiber können auch den Wert im AlignmentMask Member des DeviceObject-des Adapters verwenden.

In der folgenden Beispielfunktion wird ein Puffer als Geräteauslöser für die Datenübertragung vorbereitet.

PVOID AllocateAlignedBuffer(ULONG size, ULONG AlignmentMask, PVOID *pUnAlignedBuffer)
{
    PVOID AlignedBuffer;
    ULONG_PTR FullWordMask = (ULONG_PTR)AlignmentMask;

    if (AlignmentMask == 0)
    {
        AlignedBuffer = malloc(size);
        // return the original buffer to free later
        *pUnAlignedBuffer = AlignedBuffer;
    }
    else
    {
        // expand the size for the alignment window
        size += AlignmentMask;
        AlignedBuffer = malloc(size);
        // return the original buffer to free later
        *pUnAlignedBuffer = AlignedBuffer;
        // adjust buffer pointer for the desired alignment
        AlignedBuffer = (PVOID)(((ULONG_PTR)AlignedBuffer + FullWordMask) & ~FullWordMask);
    }

    return AlignedBuffer;
}

Anforderungen

Anforderung	Wert
Header-	ntddscsi.h (include Ntddscsi.h)

Siehe auch

IOCTL_SCSI_PASS_THROUGH

IOCTL_STORAGE_QUERY_PROPERTY

SCSI_PASS_THROUGH_DIRECT