用户层APC队列使用

一 参考

https://docs.microsoft.com/en-us/windows/desktop/api/processthreadsapi/nf-processthreadsapi-queueuserapc

<<windows核心编程>> 第5版

二 每个线程都有一个APC队列, 在线程处于可警醒状态时, 线程会执行APC队列中apc函数

　　经过以上参考文章加上测试发现, APC队列中的函数会在以下3个时机调用

　　1 线程已经创建, 系统在调用线程函数时会检查APC队列, 如果不为空, 则调用APC队列中的apc函数, 直到队列为空后, 才开始调用线程函数

　　2 线程通过WaitForSingleObjectEx等函数进入可警醒状态时, 会先检查APC队列, 如果不为空, 则调用APC队列中的apc函数, 直到队列为空后, 才开始等待要等待的对象, 此时如果要等待的对象没有进入激发态且没有超时WaitForSingleObjectEx不会返回

　　3 线程通过WaitForSingleObjectEx等函数进入可警醒状态时, APC队列为空, 且要等待的对象没有进入激发态, 也没有超时, 则线程进入睡眠等待状态, 此时往该APC队列添加APC函数后, 该线程会被唤醒执行完所有APC队列中的函数, 然后不去看要等待的对象是否进入激发态, 立即从WaitForSingleObjectEx中返回, 返回值是WAIT_IO_COMPLETION 

测试代码如下

#include <windows.h>
#include <iostream>
#include <process.h>

HANDLE hEvent = NULL;
HANDLE HMainEvent = NULL;
DWORD WINAPI TestProc(LPVOID lpThreadParameter)
{
    printf("thread start
");
    SetEvent(HMainEvent);
    if (hEvent && hEvent != INVALID_HANDLE_VALUE)
    {
        printf("waitfor start
");
        DWORD ret = WaitForSingleObjectEx(hEvent, INFINITE, TRUE);
        //WAIT_OBJECT_0
        printf("waitfor ret= 0x%08x
", ret);
    }
    printf("thread end
");
    return 0;
}
VOID NTAPI TestAPC(ULONG_PTR Parameter)
{
    printf("apc func start index=%u
",Parameter);
}
int main(int argc, char **argv, char **env)
{
    HANDLE hT = NULL;
    hEvent = CreateEvent(NULL, TRUE, FALSE, NULL);
    HMainEvent = CreateEvent(NULL, TRUE, FALSE, NULL);

    if (hEvent)
    {
        hT = (HANDLE)_beginthreadex(NULL, 0, (_beginthreadex_proc_type)TestProc, NULL, 0, NULL);
        if (hT && hT != INVALID_HANDLE_VALUE)
        {
            WaitForSingleObject(HMainEvent, INFINITE);
            //Sleep(2000);
            ULONG_PTR index = 1;
            for(;index <100;++index)
            {
                QueueUserAPC(TestAPC, hT, index);
            }
            Sleep(2000);
            SetEvent(hEvent);
            WaitForSingleObject(hT, INFINITE);
        }
    }
    CloseHandle(hEvent);
    CloseHandle(HMainEvent);
    CloseHandle(hT);
    system("pause");
    return 0;
}