AtaPortRegistryAllocateBuffer 関数 (irb.h)

  • [アーティクル]

AtaPortRegistryAllocateBuffer ルーチンは、レジストリ操作用のバッファーを割り当てます。

メモ ATA ポート ドライバーと ATA ミニポート ドライバー モデルは、今後変更または使用できない可能性があります。 代わりに、 Storport ドライバー と Storport ミニポート ドライバー モデルを使用することをお勧めします。
 

構文

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

こちらもご覧ください

AtaChannelInitRoutine

AtaPortRegistryFreeBuffer

IdeHwControl