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 返します。

必要条件

要件	価値
ターゲット プラットフォーム の	万国
ヘッダー	storport.h (Storport.h を含む)
ライブラリ	Storport.lib

関連項目

StorPortFreeRegistryBuffer の