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