WaitForSingleObject() на порт завершения?

Question

Сегодня я узнал, что я могу назвать CreateIoCompletionPort(), а затем передать возвращенное HANDLE в WaitForSingleObject():

#include <Windows.h> 

int main() 
{ 
    HANDLE h = CreateIoCompletionPort(INVALID_HANDLE_VALUE, nullptr, 0, 0); 
    auto bRes = PostQueuedCompletionStatus(h, 1, 2, 0); 
    if (!bRes) { 
     abort(); 
    } 

    auto dwRes = WaitForSingleObject(h, INFINITE); 
    if (dwRes != WAIT_OBJECT_0){ 
     abort(); 
    } 

    LPOVERLAPPED pOvr; 
    DWORD cb; 
    ULONG_PTR key; 
    bRes = GetQueuedCompletionStatus(
     h, &cb, &key, &pOvr, INFINITE); // <-- returns 1, 2, nullptr 

    if (!bRes) { 
     abort(); 
    } 

    dwRes = WaitForSingleObject(h, INFINITE); // <-- blocks here 
    return 0; 
} 

Он работает, как ожидается, на моем Windows 10 коробки.

Является ли такое поведение известным или законным или документированным? Я ничего не смог найти.

Answer 1

Если вы читаете WaitForSingleObject() documentation, ввода/вывода Завершение Порт НЕ разрешенный тип ручки:

WaitForSingleObject функция может ждать следующих объектов:

• Изменить уведомление
• Вход в консоль
• Событие
• память уведомление ресурса
• мьютекс
• Процесс
• Семафор
• Thread
• Waitable таймер

Ждать событие завершения, чтобы прибыть на порт, вы должны передать дескриптор до GetQueuedCompletionStatus() и блокировать его до тех пор, пока не произойдет событие или не произойдет тайм-аут.

#include <Windows.h> 

int main() 
{ 
    HANDLE h = CreateIoCompletionPort(INVALID_HANDLE_VALUE, nullptr, 0, 0); 
    auto bRes = PostQueuedCompletionStatus(h, 1, 2, 0); 
    if (!bRes) { 
     abort(); 
    } 

    LPOVERLAPPED pOvr; 
    DWORD cb; 
    ULONG_PTR key; 
    bRes = GetQueuedCompletionStatus(
     h, &cb, &key, &pOvr, INFINITE); // <-- returns 1, 2, nullptr 

    if (!bRes) { 
     abort(); 
    } 

    bRes = GetQueuedCompletionStatus(
     h, &cb, &key, &pOvr, INFINITE); // <-- blocks here 

    return 0; 
} 

Answer 2

Резюме:

• не делают этого. См. Ответ Remy Lebeau и MSDN о том, как правильно использовать порты завершения.
• такое злоупотребление портами завершения не только недокументировано, но и ненадежно. Поведение варьируется между сборками Windows 10.
• порт завершения, вероятно, является законным объектом для ожидания в ядре, поскольку KQUEUE, который поддерживает порт завершения, имеет DISPATCHER_HEADER.