PSCSIWMI_QUERY_REGINFO Rückruffunktion (scsiwmi.h)

Artikel
02/07/2025

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. Diese Routine ist erforderlich.

Hinweis Der SCSI-Porttreiber und die SCSI-Miniporttreibermodelle können in Zukunft geändert oder nicht mehr verfügbar sein. Stattdessen empfehlen wir die Verwendung des Storport-Treibers und Storport Miniport Treibermodelle.

Syntax

PSCSIWMI_QUERY_REGINFO PscsiwmiQueryReginfo;

UCHAR PscsiwmiQueryReginfo(
  [in]  PVOID DeviceContext,
  [in]  PSCSIWMI_REQUEST_CONTEXT RequestContext,
  [out] PWSTR *MofResourceName
)
{...}

Parameter

[in] DeviceContext

Verweist auf den miniport treiberdefinierten 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 null--terminated Unicode-Zeichenfolge, die den Namen der MOF-Ressource angibt, die der binärbilddatei des Miniporttreibers zugeordnet ist. Diese Zeichenfolge kann als Konstante im Miniporttreiber deklariert werden. Wenn der Miniporttreiber keine MOF-Ressource angefügt hat, sollte er MofResourceName- auf NULL-festlegen.

Rückgabewert

HwScsiWmiQueryReginfo gibt immer SRB_STATUS_SUCCESS zurück.

Bemerkungen

Wenn ein Miniporttreiber einen SRB empfängt, in dem das Function Member auf SRB_FUNCTION_WMI festgelegt ist, ruft er ScsiPortWmiDispatchFunction mit einem Zeiger auf eine initialisierte SCSI_WMILIB_CONTEXT Struktur auf und MinorFunction auf Srb->WmiSubFunctionfestgelegt. Wenn MinorFunction eine Anforderung für Registrierungsinformationen angibt, ruft der SCSI-Porttreiber die HwScsiWmiQueryReginfo Routine des Miniporttreibers auf.

Der Miniport-Treiber 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 er an ScsiPortWmiDispatchFunctionübergibt. Die HwScsiWmiQueryReginfo Routine des Miniporttreibers stellt einen Zeiger auf den MOF-Ressourcennamen bereit.

Der Miniporttreiber darf den SRB nicht stiften oder blockieren. Der Miniporttreiber darf nicht ScsiPortWmiPostProcess- oder ScsiPortNotification- aus der HwScsiWmiQueryReginfo Routine aufrufen.

Anforderungen

Anforderung	Wert
Zielplattform-	Desktop
Header-	scsiwmi.h (include Scsiwmi.h)

Siehe auch

SCSIWMI_REQUEST_CONTEXT

SCSI_WMILIB_CONTEXT

ScsiPortWmiDispatchFunction-

Freigeben über