StorPortCancelDpc-Funktion (storport.h)

Artikel
02/07/2025

StorPortCancelDpc versucht, die Ausführung eines verzögerten StorPort-Prozeduraufrufs (StorPort deferred procedure call, DPC) abzubrechen.

Syntax

ULONG StorPortCancelDpc(
  PVOID     HwDeviceExtension,
  PSTOR_DPC Dpc,
  BOOLEAN   *ReturnValue
);

Parameter

HwDeviceExtension

Zeiger auf die Hardwaregeräteerweiterung für den Hostbusadapter (HBA).

Dpc

Zeiger auf das STOR_DPC DPC-Objekt, das abgebrochen werden soll.

ReturnValue

Zeiger auf einen VOM Typ BOOLEAN, in dem diese Funktion einen der folgenden Werte zurückgibt.

Rückgabewert	Beschreibung
STIMMT	Die angegebene Dpc- wurde erfolgreich aus der DPC-Warteschlange des Systems entfernt.
FALSCH	Die angegebene Dpc- wurde nicht aus der DPC-Warteschlange des Systems entfernt.

Rückgabewert

Diese Funktion gibt einen der folgenden Statuscodes zurück.

Rückgabecode	Beschreibung
STOR_STATUS_INVALID_PARAMETER	Dpc oder ReturnValue- null sind.
STOR_STATUS_NOT_IMPLEMENTED	Diese Funktion ist nicht auf dem aktiven Betriebssystem implementiert.
STOR_STATUS_SUCCESS	Diese Funktion wurde erfolgreich abgeschlossen. Verwenden Sie den in ReturnValue- zurückgegebenen Wert, um zu bestimmen, ob der Dpc aus der Warteschlange entfernt wurde.

Bemerkungen

Wenn sich der angegebene StorPort-DPC in der DPC-Warteschlange befindet, StorPortCancelDpc ihn aus der Warteschlange entfernt, indem er einen Anruf an die zugeordnete DPC-Routine abbricht. Wenn sie sich nicht in der Warteschlange befindet, wurde sie entweder ausgeführt oder die Ausführung abgeschlossen und konnte daher nicht entfernt werden.

Diese Routine wird mithilfe von Inlinefunktionsdefinitionen implementiert, sodass Miniporttreiber, die sie verwenden, nicht mit Bibliotheken verknüpft werden müssen, die von der Version des Betriebssystems abhängig sind. Miniport-Treiber können diese Routine verwenden, ohne die Abwärtskompatibilität mit Versionen des Betriebssystems zu beeinträchtigen, die KEINE DPCs in Speicher-Miniporttreibern unterstützen.

Anforderungen

Anforderung	Wert
Header-	storport.h

Siehe auch

STOR_DPC

StorPortInitializeDpc-

StorPortIssueDpc

Freigeben über