方法: タスクキューハンドルの複製 - XBOX Game Development Documentation

例

長時間実行される作業がある場合は、その作業の期間中、タスクキューハンドルを複製したい場合があります。こうすると、XTaskQueueCloseHandle を呼び出す誰かが、まだキューを必要としている間にそれをクローズしてしまうことを防げます。これは次の例に示されています。

void DuplicatingTaskQueueHandle() 
{ 
    XTaskQueueHandle queue; 
 
    HRESULT hr = XTaskQueueCreate( 
        XTaskQueueDispatchMode::Manual,  
        XTaskQueueDispatchMode::Manual,  
        &queue); 
 
    if (FAILED(hr)) 
    { 
        printf("Failed to create task queue: 0x%x\r\n", hr); 
        return; 
    } 
 
    class LongRunningWork 
    { 
    public: 
        HRESULT Initialize(XTaskQueueHandle queue) 
        { 
            return XTaskQueueDuplicateHandle(queue, &m_queue); 
        } 
         
        ~LongRunningWork() 
        { 
            if (m_queue != nullptr) 
            { 
                XTaskQueueCloseHandle(m_queue); 
            } 
        } 
 
    private: 
        XTaskQueueHandle m_queue = nullptr; 
    }; 
 
    LongRunningWork work; 
    hr = work.Initialize(queue); 
     
    // Note that the queue handle for LongRunningWork is still valid. 
    XTaskQueueCloseHandle(queue); 
 
    if (FAILED(hr)) 
    { 
        printf("Failed to duplicate queue handle: 0x%x\r\n", hr); 
    } 
} 

関連項目

タスクキューの設計

最終更新日 2026年8月13日

関連トピック

SDK ライフサイクル非同期タスクキューの設計方法: タスクキューウェイターの使用 XTaskQueueDuplicateHandle タスクキューの作成例

⌘I