StorPortAllocateRegistryBuffer 関数 (storport.h)

  • [アーティクル]

StorPortAllocateRegistryBuffer ルーチンは、レジストリ データの読み取りと書き込みに使用できるバッファーを割り当てるために、ミニポート ドライバーによって呼び出されます。

構文

STORPORT_API PUCHAR StorPortAllocateRegistryBuffer(
  [in] PVOID  HwDeviceExtension,
  [in] PULONG Length
);

パラメーター

[in] HwDeviceExtension

ハードウェア デバイス拡張機能へのポインター。 これは、ポート ドライバーがミニポート ドライバーの代わりに割り当ておよび初期化する HBA 記憶域ごとの です。 ミニポート ドライバーは通常、HBA の状態や HBA のマップされたアクセス範囲など、この拡張機能に HBA 固有の情報を格納します。 この領域は、ミニポート ドライバーが StorPortInitialize を呼び出した直後に、ミニポート ドライバーで使用できます。 ポート ドライバーは、デバイスを削除すると、このメモリを解放します。 ミニポート ドライバーは、このルーチンを呼び出すときに IRQL PASSIVE_LEVELで実行されている必要があります。

[in] Length

入力時に、呼び出し元が必要とするレジストリ バッファーの長さ (バイト単位) を示す long へのポインター。 出力時に、 Length は、割り当てられたバッファーの実際のサイズ (バイト単位) を反映するように更新されます。

戻り値

StorPortAllocateRegistryBuffer は、呼び出し元が要求したレジストリ バッファーへのポインターを返します。エラーによってメモリの割り当てが妨げられる場合は NULL を 返します。

注釈

ミニポート ドライバーの各インスタンス化では、一度に 1 つのレジストリ バッファーのみを割り当てできます。 ミニポート ドライバーが複数のレジストリ バッファーを割り当てようとすると、割り当てが失敗し、 StorPortAllocateRegistryBuffer は NULL を返します。

要件

要件 値
対象プラットフォーム ユニバーサル
Header storport.h (Storport.h を含む)
Library Storport.lib

こちらもご覧ください

StorPortFreeRegistryBuffer