AtaPortRegistryAllocateBuffer 関数 (irb.h)
AtaPortRegistryAllocateBuffer ルーチンは、レジストリ操作用のバッファーを割り当てます。
構文
PVOID AtaPortRegistryAllocateBuffer(
[in] PVOID ChannelExtension,
ULONG BufferSize
);
パラメーター
[in] ChannelExtension
チャネル拡張機能へのポインター。
BufferSize
バッファーの長さをバイト単位で指定します。
戻り値
AtaPortRegistryAllocateBuffer は、成功した場合に割り当てられたバッファーへのポインターを返します。 それ以外の場合は NULL を返します。
注釈
ポート ドライバーを使用すると、ミニポート ドライバーは、すべてのレジストリ操作に 1 つのバッファーを割り当てることができます。 ミニポート ドライバーが AtaPortRegistryAllocateBuffer でバッファーを割り当てた後、後で AtaPortRegistryAllocateBuffer を呼び出すと失敗し、 NULL が返されます。 ミニポート ドライバーは、 AtaPortRegistryFreeBuffer ルーチンの呼び出しで割り当てられたバッファーを解放した後、 AtaPortRegistryAllocateBuffer を呼び出すことによってバッファーを再び割り当てることができます。
ミニポート ドライバーは、AtaChannelInitRoutine ルーチンまたは IdeHwControl ルーチンのいずれかで AtaPortRegistryAllocateBuffer を呼び出す必要があります。 他のルーチンから AtaPortRegistryAllocateBuffer を 呼び出すことはできません。 さらに、ミニポート ドライバーは、その IdeHwControl ルーチンが呼び出され、ControlAction パラメーターに StartChannel または StopChannel のいずれかの値がある場合にのみ、その IdeHwControl ルーチンから AtaPortRegistryAllocateBuffer を呼び出すことができます。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | デスクトップ |
| Header | irb.h (Ata.h、Irb.h を含む) |
| Library | Ataport.lib;Pciidex.lib |