StorPortRegistryWrite 函式 (storport.h)

  • 發行項

Miniport 驅動程式會呼叫 StorPortRegistryWrite 例程，將指定緩衝區中包含的登錄數據從 ASCII 轉換為 Unicode，然後將數據寫入迷你埠驅動程式的每個 HBA 儲存區域。

語法

STORPORT_API BOOLEAN StorPortRegistryWrite(
  [in] PVOID  HwDeviceExtension,
  [in] PUCHAR ValueName,
  [in] ULONG  Global,
  [in] ULONG  Type,
  [in] PUCHAR Buffer,
  [in] ULONG  BufferLength
);

參數

[in] HwDeviceExtension

硬體裝置擴充功能的指標。 這是每個 HBA 儲存區域，埠驅動程式會代表迷你埠驅動程式配置和初始化。 迷你埠驅動程式通常會在此延伸模組中儲存 HBA 特定資訊，例如 HBA 的狀態和 HBA 的對應存取範圍。 迷你埠驅動程式會在迷你埠驅動程式呼叫 StorPortInitialize 之後立即提供此區域。 埠驅動程式會在移除裝置時釋放此記憶體。 迷你埠驅動程序必須在 IRQL PASSIVE_LEVEL呼叫此例程時執行。

[in] ValueName

指定值名稱的字串指標。

[in] Global

指出作業是特定適配卡，還是與所有配接器相關。

[in] Type

下列其中一個登錄數據類型。

類型 意義
REG_SZ Unicode 以 Null 結尾的字串。
REG_EXPAND_SZ 具有環境變數參考的 Unicode Null 終止字串。
REG_BINARY 二進位數據。
REG_DWORD 32 位雙字。
REG_DWORD_LITTLE_ENDIAN 32 位雙字，具有小到大格式。
REG_DWORD_BIG_ENDIAN 具有大端格式的32位雙字。
REG_LINK 指定符號連結的 Unicode 字串。
REG_MULTI_SZ 多個 Unicode 字串。
REG_RESOURCE_LIST 資源對應中的資源清單。
REG_FULL_RESOURCE_DESCRIPTOR 硬體描述中的資源清單。
REG_RESOURCE_REQUIREMENTS_LIST 資源需求清單。
REG_QWORD 64 位四邊形數。
REG_QWORD_LITTLE_ENDIAN 64 位四邊形數，其格式為小到小。

[in] Buffer

緩衝區的指標，其中包含要寫入的登錄數據。

[in] BufferLength

指定 Buffer 所指向的緩衝區大小。

傳回值

如果已成功轉換和寫入登錄數據，StorPortRegistryWrite 會傳回 Boolean 值 TRUE;否則，這個例程會傳回 FALSE。

規格需求

需求 值
目標平台 Universal
標頭 storport.h (包含 Storport.h)
程式庫 Storport.lib
IRQL PASSIVE_LEVEL
DDI 合規性規則 StorPortIrql (storport)

另請參閱

StorPortInitialize