共用方式為


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

另請參閱

StorPortFreeRegistryBuffer