HW_STATE_CHANGE Rückruffunktion (storport.h)
Ein miniport bereitgestellter Rückruf, der nach einer Benachrichtigung von StorPortStateChangeDetected verarbeitet wird.
Syntax
HW_STATE_CHANGE HwStateChange;
void HwStateChange(
PVOID HwDeviceExtension,
[in, optional] PVOID Context,
[in] SHORT AddressType,
[in] PVOID Address,
[in] ULONG Status
)
{...}
Parameter
HwDeviceExtension
[in] Ein Zeiger auf den Miniporttreiber pro HBA-Speicherbereich.
[in, optional] Context
Der kontext, der als HwStateChangeContext durch den Miniport im Aufruf von StorPortStateChangeDetectedbereitgestellt wird.
[in] AddressType
Der Typ der Adresse in Adresse.
[in] Address
Ein Zeiger auf eine STOR_ADDRESS Struktur für die Entität, deren Zustandsänderung verarbeitet wurde.
[in] Status
Der Verarbeitungsstatus für die Statusänderungsbenachrichtigung.
Rückgabewert
Nichts
Bemerkungen
Die HwStorStateChange- wird mit der von Storport erworbenen StartIo-Sperre aufgerufen.
Mit diesem Rückruf können Miniports alle zusätzlichen Verarbeitungen ausführen, die nach dem Hinzufügen oder Entfernen der Hardware benötigt werden. Wenn eine Hardwareänderung auf dem HBA-Port oder Bus auftritt, kann der Miniport StorPortStateChangeDetected aufrufen, um das System des Ereignisses zu benachrichtigen.
Wenn der Wert für Status< 0x80000000 ist, war die Benachrichtigungsverarbeitung erfolgreich. Andernfalls ist der Benachrichtigungsprozess fehlgeschlagen.
Der Name HwStorStateChange ist nur ein Platzhalter für die Miniportfunktion, auf den der HwStateChange Parameter von StorPortStateChangeDetectedverweist. Der eigentliche Prototyp dieser Routine wird in Storport.h wie folgt definiert:
typedef
VOID
HW_STATE_CHANGE (
_In_ PVOID HwDeviceExtension,
_In_opt_ PVOID Context,
_In_ SHORT AddressType,
_In_ PVOID Address,
_In_ ULONG Status
);
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows 8 und höheren Versionen von Windows. |
| Zielplattform- | Universal |
| Header- | storport.h (include Storport.h) |
| IRQL- | VERSAND |