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

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

ミニポートドライバーの HwScsiWmiSetDataItem ルーチンは、データブロックのインスタンス内の 1 つのデータ項目を変更するために呼び出されます。このルーチンは省略可能です。

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

構文

PSCSIWMI_SET_DATAITEM PscsiwmiSetDataitem;

BOOLEAN PscsiwmiSetDataitem(
  [in] PVOID DeviceContext,
  [in] PSCSIWMI_REQUEST_CONTEXT RequestContext,
  [in] ULONG GuidIndex,
  [in] ULONG InstanceIndex,
  [in] ULONG DataItemId,
  [in] ULONG BufferSize,
  [in] PUCHAR Buffer
)
{...}

パラメーター

[in] DeviceContext

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

[in] RequestContext

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

[in] GuidIndex

ミニポートドライバーが ScsiPortWmiDispatchFunction に渡したSCSI_WMILIB_CONTEXT構造体内の GUID の一覧に、インデックスによってデータブロックを指定します。

[in] InstanceIndex

GuidIndex で指定されたブロックに複数のインスタンスがある場合、InstanceIndex はインスタンスを指定します。

[in] DataItemId

設定するデータ項目の ID を指定します。

[in] BufferSize

Buffer でバッファーのサイズをバイト単位で指定 します。

[in] Buffer

データ項目の新しい値を含むバッファーを指します。

戻り値

HwScsiWmiSetDataItem は、要求が保留中の場合はSRB_STATUS_PENDINGを返し、要求が完了した場合は 0 以外の SRB 状態値を返します。このルーチンによって返される SRB 状態値は、 HwScsiWmiSetDataItem に渡されたものと同じです。戻り値のデータ型は BOOLEAN ですが、 HwScsiWmiSetDataItem ルーチンは実際には SRB 状態値を返します。

注釈

ミニポートドライバーは、関数メンバーがSRB_FUNCTION_WMIに設定されている SRB を受信すると、初期化されたSCSI_WMILIB_CONTEXT構造体へのポインターを使用して ScsiPortWmiDispatchFunction を呼び出し、MinorFunction を Srb-WmiSubFunction> に設定します。 MinorFunction がデータブロックのインスタンス内の項目を変更する要求を示している場合、SCSI ポートドライバーはミニポートドライバーの HwScsiWmiSetDataItem ルーチンを呼び出します。

ミニポートドライバーが HwScsiWmiSetDataItem ルーチンを実装していない場合は、ミニポートドライバーが ScsiPortWmiDispatchFunction に渡すSCSI_WMILIB_CONTEXTで SetWmiDataItemを NULL に設定する必要があります。この状況では、ポートドライバーは呼び出し元にSRB_STATUS_ERRORを返します。

要求が処理されない場合、ミニポートドライバーは HwScsiWmiSetDataItem コールバックで ScsiPortWmiPostProcess を呼び出す必要があります。それ以外の場合、ミニポートドライバーは、要求が実際に完了したときに ScsiPortWmiPostProcess を呼び出す必要があります。ミニポートドライバーは、適切な SrbStatus 値を使用して ScsiPortWmiPostProcess を呼び出す必要があります。

アイテムが読み取り専用の場合、ミニポートドライバーは、SRB_STATUS_ERRORを使用して ScsiPortWmiPostProcess を呼び出します。それ以外の場合、ミニポートドライバーはアイテムを変更し、SRB_STATUS_SUCCESSを使用して ScsiPortWmiPostProcess を 呼び出します。