AtaPortRegistryAllocateBuffer 函式 (irb.h)
AtaPortRegistryAllocateBuffer 例程會為登錄作業配置緩衝區。
注意 ATA 埠驅動程式和 ATA 迷你埠驅動程式模型未來可能會改變或無法使用。 相反地，我們建議使用 Storport 驅動程式 和 Storport 迷你埠 驅動程式模型。
語法
PVOID AtaPortRegistryAllocateBuffer(
[in] PVOID ChannelExtension,
ULONG BufferSize
);
參數
[in] ChannelExtension
通道延伸模組的指標。
BufferSize
指定緩衝區的長度，以位元組為單位。
傳回值
AtaPortRegistryAllocateBuffer 會在成功時傳回已配置緩衝區的指標。 否則，它會傳回 NULL。
備註
埠驅動程式可讓迷你埠驅動程式為其所有登錄作業配置一個緩衝區。 在迷你埠驅動程式使用 AtaPortRegistryAllocateBuffer 配置緩衝區之後，稍後呼叫 AtaPortRegistryAllocateBuffer 將會失敗並傳回 NULL。 在迷你埠驅動程序釋放已配置的緩衝區，並呼叫 AtaPortRegistryFreeBuffer 例程之後，它就可以再次呼叫 AtaPortRegistryAllocateBuffer 來配置緩衝區。
迷你埠驅動程序必須在其 AtaChannelInitRoutine 例程或 IdeHwControl 例程中呼叫 AtaPortRegistryAllocateBuffer。 它無法從任何其他例程呼叫 AtaPortRegistryAllocateBuffer 。 此外，如果呼叫 Miniport 驅動程式的 IdeHwControl 例程，而且在其 ControlAction 參數中具有 StartChannel 或 StopChannel 的值，則只能從其 IdeHwControl 例程呼叫 AtaPortRegistryAllocateBuffer。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | 桌面 |
| 標頭 | irb.h (包括 Ata.h、Irb.h) |
| 程式庫 | Ataport.lib;Pciidex.lib |