StorPortInvokeAcpiMethod 関数 (storport.h)

  • [アーティクル]

StorPortInvokeAcpiMethod ルーチンは、ストレージ デバイスの ACPI メソッドを実行します。

構文

ULONG StorPortInvokeAcpiMethod(
  [in]            PVOID         HwDeviceExtension,
  [in, optional]  PSTOR_ADDRESS Address,
  [in]            ULONG         MethodName,
  [in, optional]  PVOID         InputBuffer,
  [in]            ULONG         InputBufferLength,
  [in, optional]  PVOID         OutputBuffer,
  [in]            ULONG         OutputBufferLength,
  [out, optional] PULONG        BytesReturned
);

パラメーター

[in] HwDeviceExtension

ホスト バス アダプター (HBA) のハードウェア デバイス拡張機能へのポインター。

[in, optional] Address

ターゲット デバイスのアドレス。 このパラメーターは省略可能です。 Address が NULL に設定されている場合、アダプターはターゲットです。

[in] MethodName

ACPI メソッドの 4 バイトの名前。 たとえば、((ULONG) 'DDS_') は、AHCI コントローラーの ACPI メソッドである _SDD または 'Set Device Data' という名前を付けます。

[in, optional] InputBuffer

メソッドへの入力データへのポインター。

[in] InputBufferLength

InputBuffer のバッファーの長さ (バイト単位)。

[in, optional] OutputBuffer

メソッドからの出力データへのポインター。

[in] OutputBufferLength

OutputBuffer のバッファーの長さ (バイト単位)。

[out, optional] BytesReturned

OutputBuffer で返されるデータの長さ (バイト単位) へのポインター。

戻り値

StorPortInvokeAcpiMethod ルーチンは、次のいずれかの状態コードを返します。

リターン コード 説明
STOR_STATUS_INVALID_UNSUCCESSFUL
 一般的なエラー条件が存在します。
STOR_STATUS_INVALID_PARAMETER
 HwDeviceExtension、 InputBuffer、または OutputBuffer が NULL です。

または

アドレス は、存在しないターゲットを参照します。
STOR_STATUS_NOT_IMPLEMENTED
 ACPI メソッドは実装されていません。
STOR_STATUS_INSUFFICIENT_RESOURCES
 メソッドを実行するためのリソースが不足しているか、 OutputBufferLength が返されるデータに対して十分な大きさではありません。
STOR_STATUS_INVALID_IRQL
 現在の IRQL > PASSIVE_LEVEL。
STOR_STATUS_SUCCESS
 メソッドが正常に実行されました。

注釈

StorPortInvokeAcpiMethod を使用すると、ミニポート ドライバーは、ストレージ コントローラーとストレージ LUN に対して定義されている ACPI メソッドを呼び出すことができます。 メソッド名は、MethodName の ULONG 値を占める 4 バイトの文字列です。

要件

要件 値
サポートされている最小のクライアント Windows 8以降のバージョンの Windows で使用できます。
対象プラットフォーム ユニバーサル
Header storport.h (Storport.h を含む)
IRQL PASSIVE_LEVEL