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 |