SpbRequestComplete-Funktion (spbcx.h)

Artikel
02/29/2024

Die SpbRequestComplete-Methode schließt eine E/A-Anforderung ab und stellt eine Vervollständigung status bereit.

Syntax

void SpbRequestComplete(
  [in] SPBREQUEST Request,
  [in] NTSTATUS   CompletionStatus
);

Parameter

[in] Request

Ein SPBREQUEST-Handle für die E/A-Anforderung, die abgeschlossen werden soll. Der SPB-Controllertreiber hat dieses Handle zuvor über eine seiner registrierten Ereignisrückruffunktionen empfangen.

[in] CompletionStatus

Ein NTSTATUS-Wert, der die Vervollständigung status der Anforderung darstellt. Gültige status-Werte umfassen folgendes, sind jedoch nicht beschränkt auf:

STATUS_SUCCESS

Die E/A-Anforderung wurde erfolgreich abgeschlossen.

STATUS_CANCELLED

Die E/A-Anforderung wird abgebrochen.

STATUS_UNSUCCESSFUL

Beim Treiber ist beim Verarbeiten der E/A-Anforderung ein Fehler aufgetreten.

Rückgabewert

Keine

Bemerkungen

Ihr Controllertreiber ruft diese Methode auf, um eine E/A-Anforderung abzuschließen, die er zuvor während eines der folgenden Rückrufe empfangen hat:

EvtSpbControllerIoOther EvtSpbControllerIoRead EvtSpbControllerIoSequence EvtSpbControllerIoWrite Ruft SpbRequestComplete anstelle der WdfRequestComplete-Methode auf, um E/A-Anforderungen abzuschließen, die von den Rückruffunktionen in der vorherigen Liste empfangen wurden.

Eine Fehlerüberprüfung tritt auf, wenn der Aufrufer ein ungültiges SPBREQUEST-Handle bereitstellt.

Ein Aufruf von SpbRequestComplete stellt die letzte Phase der Verarbeitung einer E/A-Anforderung dar. Wenn diese Methode zurückgibt, ist der Wert des Anforderungshandles nicht mehr gültig.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar ab Windows 8.
Zielplattform	Universell
Header	spbcx.h
Bibliothek	Spbcxstubs.lib
IRQL	<= DISPATCH_LEVEL