PSCSIWMI_QUERY_REGINFO Rückruffunktion (scsiwmi.h)
Die HwScsiWmiQueryReginfo-Routine eines Miniporttreibers wird aufgerufen, um Informationen zu den Daten- und Ereignisblöcken abzurufen, die im Namen des Miniporttreibers vom SCSI-Porttreiber registriert werden sollen. Diese Routine ist erforderlich.
Syntax
PSCSIWMI_QUERY_REGINFO PscsiwmiQueryReginfo;
UCHAR PscsiwmiQueryReginfo(
[in] PVOID DeviceContext,
[in] PSCSIWMI_REQUEST_CONTEXT RequestContext,
[out] PWSTR *MofResourceName
)
{...}
Parameter
[in] DeviceContext
Zeigt auf den vom Miniporttreiber definierten Kontextwert, der an ScsiPortWmiDispatchFunction übergeben wird.
[in] RequestContext
Verweist auf die SCSIWMI_REQUEST_CONTEXT Struktur, die der Miniporttreiber an ScsiPortWmiDispatchFunction übergeben hat.
[out] MofResourceName
Verweist auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die den Namen der MOF-Ressource angibt, die an die binäre Imagedatei des Miniporttreibers angefügt ist. Diese Zeichenfolge kann im Miniporttreiber als Konstante deklariert werden. Wenn dem Miniporttreiber keine MOF-Ressource angefügt ist, sollte MofResourceName auf NULL festgelegt werden.
Rückgabewert
HwScsiWmiQueryReginfo gibt immer SRB_STATUS_SUCCESS zurück.
Hinweise
Wenn ein Miniporttreiber einen SRB empfängt, in dem der Function-Member auf SRB_FUNCTION_WMI festgelegt ist, ruft er ScsiPortWmiDispatchFunction mit einem Zeiger auf eine initialisierte SCSI_WMILIB_CONTEXT-Struktur und MinorFunction auf Srb-WmiSubFunction>. Wenn MinorFunction eine Anforderung für Registrierungsinformationen angibt, ruft der SCSI-Porttreiber die HwScsiWmiQueryReginfo-Routine des Miniporttreibers auf.
Der Miniporttreiber stellt neue oder aktualisierte Registrierungsinformationen zu einzelnen Blöcken bereit oder gibt Blöcke an, die entfernt werden sollen, in der SCSI_WMILIB_CONTEXT Struktur, die an ScsiPortWmiDispatchFunction übergeben wird. Die HwScsiWmiQueryReginfo-Routine des Miniporttreibers stellt einen Zeiger auf den Namen der MOF-Ressource bereit.
Der Miniporttreiber darf den SRB nicht mit stiften oder blockieren. Der Miniporttreiber darf ScsiPortWmiPostProcess oder ScsiPortNotification nicht aus seiner HwScsiWmiQueryReginfo-Routine aufrufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | scsiwmi.h (Scsiwmi.h einschließen) |