UMDF:访问EVT_WDF_TIMER回调函数内的设备注册表项

基础概念

UMDF（User-Mode Driver Framework）是Windows驱动程序框架的一种，它允许开发者以用户模式编写驱动程序，从而降低系统崩溃的风险并简化驱动程序的开发过程。UMDF驱动程序运行在用户空间，而不是内核空间。

EVT_WDF_TIMER回调函数是UMDF中用于处理定时器事件的回调函数。当定时器触发时，系统会调用这个回调函数。

设备注册表项是Windows操作系统中用于存储设备特定配置信息的键值对集合。UMDF驱动程序可以通过访问这些注册表项来获取或设置设备的配置信息。

类型

UMDF驱动程序主要分为两类：

内核模式客户端驱动程序（KMDF）：虽然这不是UMDF的一部分，但值得一提的是，KMDF是另一种Windows驱动程序框架，它允许开发者以内核模式编写驱动程序。
用户模式驱动程序（UMDF）：如前所述，UMDF允许开发者以用户模式编写驱动程序。

应用场景

UMDF驱动程序适用于以下场景：

硬件设备：用于控制和管理硬件设备的驱动程序。
文件系统：用于实现自定义文件系统的驱动程序。
网络协议：用于实现自定义网络协议的驱动程序。

访问设备注册表项

在UMDF中，可以通过WdfDeviceGetRegistryKey函数获取设备的注册表项句柄，然后使用Windows API函数（如RegGetValue）来读取或写入注册表项。

以下是一个简单的示例代码，展示了如何在EVT_WDF_TIMER回调函数内访问设备注册表项：

#include <windows.h>
#include <wdf.h>

NTSTATUS
MyTimerCallback(
    _In_ WDFTIMER Timer
    )
{
    NTSTATUS status;
    WDFDEVICE device;
    HANDLE registryKeyHandle;
    WCHAR valueName[] = L"MyValue";
    DWORD valueData;
    DWORD valueType;

    // 获取设备对象
    device = WdfTimerGetDevice(Timer);

    // 获取设备注册表项句柄
    status = WdfDeviceGetRegistryKey(device, PLUGPLAY_REGKEY_DRIVER, &registryKeyHandle);
    if (!NT_SUCCESS(status)) {
        KdPrint(("Failed to get registry key handle: 0x%X\n", status));
        return status;
    }

    // 读取注册表项值
    status = RegGetValue(registryKeyHandle, NULL, valueName, RRF_RT_REG_DWORD, &valueType, (PVOID)&valueData, sizeof(valueData));
    if (!NT_SUCCESS(status)) {
        KdPrint(("Failed to read registry value: 0x%X\n", status));
    } else {
        KdPrint(("Registry value: %lu\n", valueData));
    }

    // 关闭注册表项句柄
    RegCloseKey(registryKeyHandle);

    return STATUS_SUCCESS;
}