ReadDirectoryChangesW监控目录时创建子目录未触发通知问题

嘿，这问题我之前踩过坑！咱们一步步来排查解决：

最核心的问题：过滤掩码漏了目录变更事件 #

ReadDirectoryChangesW的第四个参数（过滤掩码）是关键——如果你只设置了FILE_NOTIFY_CHANGE_FILE_NAME，它只会响应文件的创建/删除/重命名，完全不会触发目录相关的通知。必须把FILE_NOTIFY_CHANGE_DIR_NAME也加进去，或者直接用FILE_NOTIFY_CHANGE_ALL覆盖所有变更类型。

正确的掩码设置示例：

FILE_NOTIFY_CHANGE_DIR_NAME | FILE_NOTIFY_CHANGE_FILE_NAME

其他必查细节 #

• 目录打开参数是否正确：用CreateFile打开目录时，必须加上FILE_FLAG_BACKUP_SEMANTICS标志，这是监控目录的必要前提，少了它根本没法正常工作。
• 缓冲区与结构体对齐：FILE_NOTIFY_INFORMATION是可变长度结构体，如果缓冲区太小或者没有正确对齐，可能会导致通知被截断，WaitForSingleObjectEx就会一直卡着。建议用至少1024字节的缓冲区，并且确保结构体对齐（比如用__declspec(align(8))修饰）。
• OVERLAPPED事件初始化：要确保创建的事件句柄是有效的，且为手动重置类型（CreateEvent的第二个参数设为TRUE），不然可能出现单次通知后无法继续监控的情况。

简化的可运行示例代码 #

这里给你一段调整后的正确代码，你可以参考修改自己的实现：

#include <windows.h>
#include <wchar.h>

int main() {
    // 打开目标监控目录
    HANDLE hDir = CreateFileW(
        L"c:\\testA\\testB",
        FILE_LIST_DIRECTORY,
        FILE_SHARE_READ | FILE_SHARE_WRITE | FILE_SHARE_DELETE,
        NULL,
        OPEN_EXISTING,
        FILE_FLAG_BACKUP_SEMANTICS | FILE_FLAG_OVERLAPPED,
        NULL
    );

    if (hDir == INVALID_HANDLE_VALUE) {
        wprintf(L"打开目录失败，错误码：%d\n", GetLastError());
        return 1;
    }

    // 初始化异步监控的OVERLAPPED结构
    OVERLAPPED overlapped = {0};
    overlapped.hEvent = CreateEventW(NULL, TRUE, FALSE, NULL);
    if (overlapped.hEvent == NULL) {
        wprintf(L"创建事件失败，错误码：%d\n", GetLastError());
        CloseHandle(hDir);
        return 1;
    }

    BYTE buffer[1024];
    DWORD bytesReturned;

    // 启动监控：包含文件和目录的新增/变更事件
    BOOL success = ReadDirectoryChangesW(
        hDir,
        buffer,
        sizeof(buffer),
        FALSE, // 只监控当前目录，若需监控子目录层级设为TRUE
        FILE_NOTIFY_CHANGE_DIR_NAME | FILE_NOTIFY_CHANGE_FILE_NAME,
        &bytesReturned,
        &overlapped,
        NULL
    );

    if (!success) {
        wprintf(L"启动监控失败，错误码：%d\n", GetLastError());
        CloseHandle(overlapped.hEvent);
        CloseHandle(hDir);
        return 1;
    }

    // 等待变更通知触发
    DWORD waitResult = WaitForSingleObjectEx(overlapped.hEvent, INFINITE, TRUE);
    if (waitResult == WAIT_OBJECT_0) {
        // 解析并处理通知内容
        FILE_NOTIFY_INFORMATION* pNotify = (FILE_NOTIFY_INFORMATION*)buffer;
        do {
            wchar_t fileName[MAX_PATH];
            wcsncpy_s(fileName, pNotify->FileName, pNotify->FileNameLength / sizeof(wchar_t));
            fileName[pNotify->FileNameLength / sizeof(wchar_t)] = L'\0';

            switch (pNotify->Action) {
                case FILE_ACTION_ADDED:
                    wprintf(L"新增了：%s\n", fileName);
                    break;
                case FILE_ACTION_REMOVED:
                    wprintf(L"删除了：%s\n", fileName);
                    break;
                // 可根据需求添加其他事件的处理逻辑
            }

            pNotify = (FILE_NOTIFY_INFORMATION*)((BYTE*)pNotify + pNotify->NextEntryOffset);
        } while (pNotify->NextEntryOffset != 0);
    } else {
        wprintf(L"等待通知失败，错误码：%d\n", GetLastError());
    }

    // 清理资源
    CloseHandle(overlapped.hEvent);
    CloseHandle(hDir);
    return 0;
}

补充说明 #

你提到监控c:\testA能收到testB里创建子目录的通知，大概率是因为监控testA时的过滤掩码包含了目录变更，而监控testB时漏掉了。把掩码补全后，问题应该就能解决啦！

内容的提问来源于stack exchange，提问作者alvion