StorPortRegistryReadAdapterKey 函式 (storport.h)
Miniport 驅動程式會呼叫 StorPortRegistryReadAdapterKey 例程，以讀取位於 HKLM/CurrentControlSet/Enum/Instance path/DeviceParameters/...這些金鑰會在 INF DDInstall.HW 區段中讀取。
語法
ULONG StorPortRegistryReadAdapterKey(
[in] PVOID HwDeviceExtension,
[in, optional] PUCHAR SubKeyName,
[in] PUCHAR ValueName,
[in] ULONG ValueType,
[in, out] PVOID *ValueData,
[in, out] PULONG 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，否則傳回適當的錯誤碼。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Universal |
| 標頭 | storport.h (包含 Storport.h) |
| 程式庫 | Storport.lib |
| IRQL | PASSIVE_LEVEL |