IOCTL_SCSI_PASS_THROUGH_DIRECT IOCTL (ntddscsi.h)

Ermöglicht einer Anwendung das Senden von fast jedem SCSI-Befehl an ein Zielgerät mit den folgenden Einschränkungen:

• Multitarget-Befehle, z. B. COPY, 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 nur direkt an den Systemporttreiber für eine logische Zieleinheit senden, wenn kein Klassentreiber für den Gerätetyp vorhanden ist, der mit dieser LU verbunden ist.
• Diese Anforderung muss gestellt werden, wenn die Eingabe-CDB möglicherweise erfordert, dass der zugrunde liegende Miniporttreiber direkt auf den Arbeitsspeicher zugreifen kann.

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

Bewerbungen 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 wird empfohlen, die Modelle Storport-Treiber und Storport-Miniporttreiber zu verwenden.

 

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

Diese Struktur enthält ein SCSI-CDB, das vom Aufrufer initialisiert werden muss, mit Ausnahme des Pfads, der Ziel-ID und der LUN, die vom Porttreiber eingegeben werden. Für einen Data-Out-Befehl müssen sich die zu übertragenden Daten in einem Adaptergerät ausgerichteten Puffer befinden. Das DataBuffer-Element von SCSI_PASS_THROUGH_DIRECT ist ein Zeiger auf diesen adaptergeräteorientierten Puffer. Der Aufrufer muss zusätzlichen Speicher gemäß der SCSI_PASS_THROUGH_DIRECT Struktur zuweisen, wenn der Aufrufer nach Anforderungssinnsdaten fragt.

Eingabepufferlänge

Parameters.DeviceIoControl.InputBufferLength gibt die Größe des Puffers in Bytes bei Irp->AssociatedIrp.SystemBuffer an, die mindestens sein muss (Sense data sizeof + (SCSI_PASS_THROUGH_DIRECT)). Die Größe der SCSI_PASS_THROUGH_DIRECT-Struktur ist festgelegt.

Ausgabepuffer

Der Porttreiber gibt alle Anforderungssinnsdaten und die SCSI_PASS_THROUGH_DIRECT-Struktur an den Puffer von Irp-AssociatedIrp.SystemBuffer> zurück.

Länge des Ausgabepuffers

SenseInfoLength und DataTransferLength werden aktualisiert, um die übertragene Datenmenge anzugeben. Der Porttreiber gibt alle Daten zurück, die vom Gerät an den bereitgestellten cacheorientierten Puffer bei DataBuffer übertragen werden.

Statusblock

Das Feld Information ist auf die Anzahl der Bytes festgelegt, die im Ausgabepuffer bei Irp-AssociatedIrp.SystemBuffer> zurückgegeben werden. Das Feld Status ist auf STATUS_SUCCESS oder möglicherweise auf STATUS_BUFFER_TOO_SMALL oder STATUS_INVALID_PARAMETER festgelegt, wenn der Eingabelängenwert in SCSI_PASS_THROUGH_DIRECT nicht ordnungsgemäß festgelegt ist oder der in DataBuffer angegebene Puffer nicht ordnungsgemäß auf das Gerät ausgerichtet ist.

Hinweise

Für Datenübertragungsvorgänge ist ein Puffer mit einer Ausrichtung erforderlich, die dem Adaptergerät entspricht. Anwendungen können die Geräteausrichtungsmaske abrufen, indem sie eine IOCTL_STORAGE_QUERY_PROPERTY Steuerelementcodeanforderung mit dem Abfragetyp PropertyStandardQuery und der Eigenschaften-ID von StorageAdapterProperty ausstellen. Die Ausrichtungsmaske 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äteorientierter Datenübertragungspuffer 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)

Weitere Informationen

IOCTL_SCSI_PASS_THROUGH

IOCTL_STORAGE_QUERY_PROPERTY

SCSI_PASS_THROUGH_DIRECT