ScsiPortWmiGetInstanceName 関数 (scsiwmi.h)
ScsiPortWmiGetInstanceName ルーチンは、示された Windows Management Instrumentation (WMI) SCSI 要求ブロック (SRB) に関連付けられているインスタンス名へのポインターを返します。
構文
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 を呼び出し、最終的な SRB 状態とバッファー サイズを返 ScsiPortWmiPostProcess するまで有効なままである必要があります。 SRB がペンドできる場合は、要求コンテキストのメモリを SRB 拡張機能から割り当てる必要があります。 SRB がペンできない場合は、スコープ外に出ないスタック フレームからメモリを割り当てることができます。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の | デスクトップ |
| ヘッダー | scsiwmi.h (ミニポート h、Scsi.h を含む) |