共用方式為


StorPortRegistryWriteAdapterKey 函式 (storport.h)

迷你埠驅動程式會呼叫 StorPortRegistryReadAdapterKey 例程,以讀取位於 HKLM/CurrentControlSet/Enum/ 登錄中的硬件或裝置登錄配接器機碼,實例路徑/DeviceParameters/...這些索引鍵會在 INF DDInstall.HW 區段中讀取

語法

ULONG StorPortRegistryWriteAdapterKey(
  [in]           PVOID  HwDeviceExtension,
  [in, optional] PUCHAR SubKeyName,
  [in]           PUCHAR ValueName,
  [in]           ULONG  ValueType,
  [in, out]      PVOID  ValueData,
  [in, out]      ULONG  ValueDataLength
);

參數

[in] HwDeviceExtension

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

[in, optional] SubKeyName

迷你埠子機碼。

[in] ValueName

索引鍵底下的 Value 名稱。

[in] ValueType

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

類型 意義
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, out] ValueData

包含要讀取之登錄數據的數據指標。 數據會從 UNICODE 轉換成 NULL 終止的 ASCII 字串。

[in, out] ValueDataLength

指定 ValueData 所指向的數據大小

傳回值

當作業成功時,傳回STOR_STATUS_SUCCESS,否則傳回適當的錯誤碼。

要求

要求 價值
目標平臺 普遍
標頭 storport.h (包括 Storport.h)
連結庫 Storport.lib
IRQL PASSIVE_LEVEL

另請參閱

StorPortInitialize