方法: タスクキューウェイターの使用 - XBOX Game Development Documentation

例

Win32 カーネルハンドルをタスクキューに登録できます。ハンドルがシグナル状態になると、コールバックがキューに送信されます。通常は、シグナル用に自動リセットイベントを作成します。ハンドルが自動リセットでない場合、ハンドルがシグナル状態である間、現在のコールバックが完了すると新しいコールバックが送信されます。次の例は、タスクキューウェイターの使用方法を示しています。

void CreatingTaskQueueWaiter()  
{  
    HANDLE waitEvent = CreateEvent(nullptr, FALSE, FALSE, nullptr);  
    if (waitEvent == nullptr)  
    {  
        printf("Error creating wait handle: %d\r\n", GetLastError());  
        return;  
    }  
  
    XTaskQueueHandle queue;  
  
    HRESULT hr = XTaskQueueCreate(  
        XTaskQueueDispatchMode::ThreadPool,  
        XTaskQueueDispatchMode::ThreadPool,  
        &queue);  
  
    if (FAILED(hr))  
    {  
        printf("Error creating task queue: %x\n", hr);  
        CloseHandle(waitEvent);  
        return;  
    }  
  
    auto callback = [](void*, bool)  
    {  
        printf("Callback invoked.\r\n");  
    };  
  
    XTaskQueueRegistrationToken token;  
  
    hr = XTaskQueueRegisterWaiter(  
        queue,  
        XTaskQueuePort::Completion,  
        waitEvent,  
        nullptr,  
        callback,  
        &token);  
  
    if (FAILED(hr))  
    {  
        printf("Error registering task queue waiter: %x\n", hr);  
        CloseHandle(waitEvent);  
        XTaskQueueCloseHandle(queue);  
        return;  
    }  
  
    // Now, whenever our wait event becomes signaled, the callback will be called.  
    for (uint32_t i = 0; i < 5; i++)  
    {  
        SetEvent(waitEvent);  
        Sleep(100);  
    }  
  
    // Note: Unregistering the waiter is optional.  
    XTaskQueueUnregisterWaiter(queue, token);  
    XTaskQueueCloseHandle(queue);  
    CloseHandle(waitEvent);  
}  

サンプル出力

Callback invoked.  
Callback invoked.  
Callback invoked.  
Callback invoked.  
Callback invoked.  

関連項目

タスクキューの設計

最終更新日 2026年8月13日

関連トピック

方法: プロセスタスクキューの使用非同期タスクキューの設計 XBOX Services API (XSAPI) の使用方法方法: 遅延コールバックの使用方法: 手動タスクキューの作成

⌘I