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) |