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 |