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 的指標,指出在輸入時,呼叫端所需的登錄緩衝區長度以位元組為單位。 在輸出上, Length 會更新,以反映所配置緩衝區的實際位元組大小。
傳回值
StorPortAllocateRegistryBuffer 會傳回呼叫端所要求的登錄緩衝區指標,如果某些錯誤導致記憶體無法配置,則為 NULL 。
備註
迷你埠驅動程式的每個具現化一次只能配置一個登錄緩衝區。 如果迷你埠驅動程序嘗試配置多個登錄緩衝區,配置將會失敗, 而且 StorPortAllocateRegistryBuffer 會傳回 NULL。
規格需求
需求 | 值 |
---|---|
目標平台 | Universal |
標頭 | storport.h (包含 Storport.h) |
程式庫 | Storport.lib |