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 如果登錄數據成功轉換並寫入,則會傳回布爾值 TRUE;否則,這個例程會傳回 FALSE。
要求
要求 | 價值 |
---|---|
目標平臺 | 普遍 |
標頭 | storport.h (包括 Storport.h) |
連結庫 | Storport.lib |
IRQL | PASSIVE_LEVEL |
DDI 合規性規則 | StorPortIrql(storport) |