StorPortAllocateRegistryBuffer 函式 (storport.h)
miniport 驅動程式會呼叫 StorPortAllocateRegistryBuffer 例程,以配置可用來讀取和寫入登錄數據的緩衝區。
語法
STORPORT_API PUCHAR StorPortAllocateRegistryBuffer(
[in] PVOID HwDeviceExtension,
[in] PULONG Length
);
參數
[in] HwDeviceExtension
硬體裝置延伸模組的指標。 這是埠驅動程式代表迷你埠驅動程式配置和初始化的每個 HBA 儲存區域。 迷你埠驅動程式通常會在此延伸模組中儲存 HBA 特定資訊,例如 HBA 的狀態和 HBA 的對應存取範圍。 迷你埠驅動程式呼叫 StorPortInitialize之後,即可立即取得此區域。 埠驅動程式會在移除裝置時釋放此記憶體。 迷你埠驅動程序必須在 IRQL PASSIVE_LEVEL呼叫此例程時執行。
[in] Length
long 的指標,指出在輸入時,呼叫端所需的登錄緩衝區長度以位元組為單位。 在輸出中,長度 會更新,以反映已配置之緩衝區的實際位元組大小。
傳回值
StorPortAllocateRegistryBuffer 會傳回呼叫者所要求的登錄緩衝區指標,或如果某些錯誤導致記憶體無法配置,則 NULL。
言論
迷你埠驅動程式的每個具現化一次只能配置一個登錄緩衝區。 如果迷你連接埠驅動程式嘗試設定多個登入緩衝區,配置將會失敗,而且 storPortAllocateRegistryBuffer 會傳回 NULL 。
要求
要求 | 價值 |
---|---|
目標平臺 | 普遍 |
標頭 | storport.h (包括 Storport.h) |
連結庫 | Storport.lib |