PSCSIWMI_QUERY_REGINFO回呼函式 (scsiwmi.h)

系統會呼叫迷你埠驅動程式的 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

指向 Null 終止的 Unicode 字串，指出附加至迷你埠驅動程式二進位圖像檔之 MOF 資源的名稱。 此字串可以在迷你埠驅動程式中宣告為常數。 如果迷你埠驅動程序沒有附加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。

規格需求

需求	值
目標平台	桌面
標頭	scsiwmi.h (包含 Scsiwmi.h)

另請參閱

SCSIWMI_REQUEST_CONTEXT

SCSI_WMILIB_CONTEXT

ScsiPortWmiDispatchFunction