StorPortCancelDpc-Funktion (storport.h)
StorPortCancelDpc versucht, die Ausführung eines StorPort-Aufrufs für verzögerte Prozeduren (DPC) abzubrechen.
Syntax
ULONG StorPortCancelDpc(
PVOID HwDeviceExtension,
PSTOR_DPC Dpc,
BOOLEAN *ReturnValue
);
Parameter
HwDeviceExtension
Zeiger auf die Hardwaregeräteerweiterung für den Host Bus Adapter (HBA).
Dpc
Zeiger auf das STOR_DPC DPC-Objekt, das abgebrochen werden soll.
ReturnValue
Zeiger auf einen BOOLEAN , in dem diese Funktion einen der folgenden Werte zurückgibt.
| Rückgabewert | Beschreibung |
|---|---|
| TRUE | Der angegebene DPC wurde erfolgreich aus der DPC-Warteschlange des Systems entfernt. |
| false | Der angegebene DPC wurde nicht aus der DPC-Warteschlange des Systems entfernt. |
Rückgabewert
Diese Funktion gibt einen der folgenden status Codes zurück.
| Code zurückgeben | BESCHREIBUNG |
|---|---|
| STOR_STATUS_INVALID_PARAMETER | Dpc oder ReturnValue sind NULL. |
|
Diese Funktion ist auf dem aktiven Betriebssystem nicht 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. |
Hinweise
Wenn sich der angegebene StorPort-DPC in der DPC-Warteschlange befindet, entfernt StorPortCancelDpc ihn aus der Warteschlange und bricht einen Aufruf der zugehörigen DPC-Routine ab. Wenn es sich nicht in der Warteschlange befindet, wurde es entweder ausgeführt oder war 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üpfen 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 Speicherminiporttreibern unterstützen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | storport.h |