PSCSIWMI_QUERY_REGINFO コールバック関数 (scsiwmi.h)

[アーティクル]
02/27/2024

ミニポートドライバーの HwScsiWmiQueryReginfo ルーチンは、SCSI ポートドライバーによってミニポートドライバーの代わりに登録されるデータとイベントブロックに関する情報を取得するために呼び出されます。このルーチンは必須です。

メモ SCSI ポートドライバーと SCSI ミニポートドライバーモデルは、今後変更または使用できない可能性があります。代わりに、 Storport ドライバーと Storport ミニポートドライバーモデルを使用することをお勧めします。

構文

PSCSIWMI_QUERY_REGINFO PscsiwmiQueryReginfo;

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

パラメーター

[in] DeviceContext

ScsiPortWmiDispatchFunction に渡されるミニポートドライバーで定義されたコンテキスト値を指します。

[in] RequestContext

ミニポートドライバーが ScsiPortWmiDispatchFunction に渡したSCSIWMI_REQUEST_CONTEXT構造体を指します。

[out] MofResourceName

ミニポートドライバーのバイナリイメージファイルにアタッチされている MOF リソースの名前を示す null で終わる Unicode 文字列を指します。この文字列は、ミニポートドライバーで定数として宣言できます。ミニポートドライバーに MOF リソースがアタッチされていない場合は、 MofResourceName を NULL に設定する必要があります。

戻り値

HwScsiWmiQueryReginfo は 常にSRB_STATUS_SUCCESSを返します。

注釈

ミニポートドライバーは、Function メンバーがSRB_FUNCTION_WMIに設定されている SRB を受信すると、初期化されたSCSI_WMILIB_CONTEXT構造体へのポインターを使用して ScsiPortWmiDispatchFunction を呼び出し、MinorFunction を Srb-WmiSubFunction> に設定します。 MinorFunction が登録情報の要求を示す場合、SCSI ポートドライバーはミニポートドライバーの HwScsiWmiQueryReginfo ルーチンを呼び出します。

ミニポートドライバーは、 ScsiPortWmiDispatchFunction に渡されるSCSI_WMILIB_CONTEXT構造で、個々のブロックに関する新規または更新された登録情報を提供するか、削除するブロックを示します。ミニポートドライバーの HwScsiWmiQueryReginfo ルーチンは、MOF リソース名へのポインターを提供します。

ミニポートドライバーは、SRB をペンまたはブロックすることはできません。ミニポートドライバーは、その HwScsiWmiQueryReginfo ルーチンから ScsiPortWmiPostProcess または ScsiPortNotification を呼び出す必要があります。