Skip to main content

XTaskQueueGetPort

指定されたポートに対応するタスク キュー ポート ハンドルを返します。

構文

パラメーター

queue   _In_
Type: XTaskQueueHandle
ポートを取得するタスク キューです。 port   _In_
Type: XTaskQueuePort
取得するポートです。 portHandle   _Out_
Type: XTaskQueuePortHandle*
指定されたポートに対応するタスク キュー ポート ハンドルです。

戻り値

Type: HRESULT HRESULT の成功またはエラー コード。

解説

この関数は、時間依存スレッドで呼び出しても安全ではありません。詳細については、Time-sensitive threads を参照してください。
タスク キュー ポート ハンドルはタスク キューによって所有されているため、閉じる必要はありません。これらはコンポジット タスク キューを作成するときに使用されます。 次の例では、ワーク ポートと完了ポートの両方に元のキューのワーク ポートを使用するコンポジット キューを作成します。コンポジット タスク キューとは、他のキューの部品から構成されるタスク キューです。コンポジット タスク キューは、ある非同期タスクから別の非同期タスクを呼び出す必要があり、そのタスクからの完了が中間ステップに過ぎず、完了スレッドのサイクルを無駄にすべきでない場合に役立ちます。
SubmitCallback は、XTaskQueueSubmitCallback 関数のコード例で定義されているヘルパー関数です。

要件

ヘッダー: XTaskQueue.h ライブラリ: xgameruntime.lib サポートされているプラットフォーム: Windows、XBOX One 本体、XBOX Series 本体

概念ドキュメント

関連項目

XTaskQueue members
非同期プログラミング モデル
非同期タスク キューの設計
最終更新日 2026年8月24日