ScsiPortWmiGetInstanceName 関数 (scsiwmi.h)

[アーティクル]
08/07/2023

ScsiPortWmiGetInstanceName ルーチンは、示されている Windows Management Instrumentation (WMI) SCSI 要求ブロック (SRB) に関連付けられているインスタンス名へのポインターを返します。

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

構文

PWCHAR ScsiPortWmiGetInstanceName(
  [in] PSCSIWMI_REQUEST_CONTEXT RequestContext
);

パラメーター

[in] RequestContext

WMI SRB の要求コンテキストを含むSCSIWMI_REQUEST_CONTEXT型の構造体へのポインター。

戻り値

指定された SRB に関連付けられているインスタンス名を含むカウントされた文字列へのポインター。 SRB 型がインスタンス名を使用しない型の場合、 ScsiPortWmiGetInstanceName は NULL を返します。

注釈

パラメーター RequestContext は、Windows Management Instrumentation (WMI) SCSI 要求ブロック (SRB) に関連付けられた情報を含む要求コンテキスト構造 (SCSIWMI_REQUEST_CONTEXT) を指します。要求コンテキスト構造には、ユーザーモードのデータコンシューマーとカーネルモードのデータプロバイダー (ドライバーなど) の間でデータを渡すために WMI システムによって使用される WMI WNODE_XXX 構造体のいずれかが含まれます。

要求コンテキストに含まれるWNODE_XXX構造体には、WMI SRB に関連付けられたインスタンス名が保持されます。ミニポートドライバーは、要求コンテキストからこのインスタンス名を抽出する ScsiPortWmiGetInstanceName を呼び出します。

要求コンテキストに割り当てられたメモリは、ミニポートドライバーが ScsiPortWmiPostProcess を呼び出し、 ScsiPortWmiPostProcess が最終的な SRB 状態とバッファーサイズを返すまで有効なままである必要があります。 SRB をペンドできる場合は、要求コンテキストのメモリを SRB 拡張機能から割り当てる必要があります。 SRB がペンドできない場合は、スコープ外に出ないスタックフレームからメモリを割り当てることができます。