[适用于 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类型 成员。
[in] Memory
框架内存对象的句柄。 此对象表示一个缓冲区，其中包含将分配给 ValueName 指向的值名称的数据。
[in, optional] MemoryOffsets
指向驱动程序提供的 WDFMEMORY_OFFSET 结构的指针，该结构标识 内存 指定的缓冲区的子节。 此参数是可选的，可以 NULL。
返回值
WdfRegistryAssignMemory 如果作成功，则返回STATUS_SUCCESS。 否则，该方法可能会返回以下值之一：
| 返回代码 | 说明 |
|---|---|
|
|
|
指定了无效参数。 |
|
驱动程序未打开具有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） |
| 图书馆 | Wdf01000.sys（KMDF）：WUDFx02000.dll （UMDF） |
| IRQL | PASSIVE_LEVEL |
| DDI 符合性规则 | DriverCreate（kmdf），KmdfIrql（kmdf），KmdfIrql2（kmdf），KmdfIrqlExplicit（kmdf） |