StorPortDeviceBusy-Funktion (storport.h)
Der StorPortDeviceBusy Routine benachrichtigt den Porttreiber, dass die angegebene logische Einheit aktuell ausgelastet ist und ausstehende Anforderungen verarbeitet.
Syntax
STORPORT_API BOOLEAN StorPortDeviceBusy(
[in] PVOID HwDeviceExtension,
[in] UCHAR PathId,
[in] UCHAR TargetId,
[in] UCHAR Lun,
[in] ULONG RequestsToComplete
);
Parameter
[in] HwDeviceExtension
Ein Zeiger auf die Hardwaregeräteerweiterung. Dies ist ein HBA-Speicherbereich, den der Porttreiber im Namen des Miniporttreibers zuweist und initialisiert. Miniporttreiber speichern in der Regel HBA-spezifische Informationen in dieser Erweiterung, z. B. den Zustand der HBA und die zugeordneten Zugriffsbereiche für die HBA. Dieser Bereich steht dem Miniporttreiber unmittelbar nach dem Aufruf StorPortInitializezur Verfügung. Der Porttreiber gibt diesen Speicher frei, wenn es das Gerät entfernt.
[in] PathId
Identifiziert den SCSI-Bus.
[in] TargetId
Identifiziert den Zielcontroller oder das Gerät auf den angegebenen Bussen.
[in] Lun
Identifiziert die logische Einheit für den angegebenen Zielcontroller oder das angegebene Gerät.
[in] RequestsToComplete
Gibt die Anzahl der Anforderungen an, die die logische Einheit abschließen muss, bevor E/A-Anforderungen an den Miniporttreiber fortgesetzt werden. Wenn RequestsToComplete- größer als die Anzahl der derzeit ausstehenden Anforderungen ist, führt der Storport-Treiber alle ausstehenden Anforderungen an die logische Einheit aus, bevor Anforderungen fortgesetzt werden.
Rückgabewert
StorPortDeviceBusy gibt TRUE zurück, wenn der Miniporttreiber erfolgreich den Porttreiber benachrichtigen konnte, FALSE wenn nicht.
Bemerkungen
Es wird kein Fehlerprotokoll generiert, wenn ein Gerät ausgelastet ist.
Der Porttreiber gibt keine neuen Anforderungen an die logische Einheit aus, bis die Warteschlange der logischen Einheit auf eine ausreichende Ebene entwässert wurde, auf der die Verarbeitung fortgesetzt werden kann.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Universal |
| Header- | storport.h (include Storport.h) |
| Library | Storport.lib |