WdfRegistryAssignMemory 函数 (wdfregistry.h)
[适用于 KMDF 和 UMDF]
WdfRegistryAssignMemory 方法将包含在指定内存缓冲区中的数据分配给注册表中的指定值名称。
语法
NTSTATUS WdfRegistryAssignMemory(
[in] WDFKEY Key,
[in] PCUNICODE_STRING ValueName,
[in] ULONG ValueType,
[in] WDFMEMORY Memory,
[in, optional] PWDFMEMORY_OFFSET MemoryOffsets
);
参数
[in] Key
表示打开的注册表项的注册表项对象的句柄。
[in] ValueName
指向包含值名称 的UNICODE_STRING 结构的指针。
[in] ValueType
一个标识数据类型的值。 有关数据类型值的列表，请参阅 KEY_VALUE_BASIC_INFORMATION 的 Type 成员。
[in] Memory
框架内存对象的句柄。 此对象表示一个缓冲区，该缓冲区包含将分配给 ValueName 指向的值名称的数据。
[in, optional] MemoryOffsets
指向驱动程序提供的 WDFMEMORY_OFFSET 结构的指针，该结构标识 Memory 指定的缓冲区的子部分。 此参数是可选的，可以为 NULL。
返回值
如果操作成功，WdfRegistryAssignMemory 将返回STATUS_SUCCESS。 否则，方法可能会返回以下值之一：
| 返回代码 | 说明 |
|---|---|
|
未在 IRQL = PASSIVE_LEVEL调用 WdfRegistryAssignMemory。 |
|
指定的参数无效。 |
|
驱动程序未打开具有KEY_SET_VALUE访问权限的注册表项。 |
|
指定的 MemoryOffsets 参数无效的WDFMEMORY_OFFSET结构的内容。 |
此方法还可能返回其他 NTSTATUS 值。
如果驱动程序提供无效的对象句柄，则会发生 bug 检查。
注解
如果 ValueName 参数指定的值名称已存在， 则 WdfRegistryAssignMemory 会更新值的数据。
有关注册表项对象的详细信息，请参阅 在 Framework-Based 驱动程序中使用注册表。
示例
下面的代码示例创建一个框架内存对象，使用假数据加载对象的缓冲区，并将缓冲区的内容分配给注册表值。
PUCHAR pBuffer;
WDFMEMORY memory;
NTSTATUS status;
UCHAR i;
DECLARE_UNICODE_STRING_SIZE(valueName, L"MyValueName");
status = WdfMemoryCreate(
WDF_NO_OBJECT_ATTRIBUTES,
NonPagedPool,
0,
MEMORY_LENGTH,
&memory,
(PVOID*)&pBuffer
);
if (NT_SUCCESS(status)) {
// Fill the buffer with fake data.
for (i = 1; i <= MEMORY_LENGTH; i++) {
pBuffer[i-1] = i;
}
status = WdfRegistryAssignMemory(
Key,
&valueName,
REG_BINARY,
memory,
NULL
);
}
要求
| 要求 | 值 |
|---|---|
| 目标平台 | 通用 |
| 最低 KMDF 版本 | 1.0 |
| 最低 UMDF 版本 | 2.0 |
| 标头 | wdfregistry.h (包括 Wdf.h) |
| Library | Wdf01000.sys (KMDF) ;WUDFx02000.dll (UMDF) |
| IRQL | PASSIVE_LEVEL |
| DDI 符合性规则 | DriverCreate (kmdf) 、 KmdfIrql (kmdf) 、 KmdfIrql2 (kmdf) 、 KmdfIrqlExplicit (kmdf) |