XApuDisconnect
ハードウェア サーバーから切断し、XApuConnect の間に割り当てられたすべてのリソースを解放します。構文
パラメーター
handle _In_型: XApuHandle XApuConnect の呼び出しによって返されたハンドル。
戻り値
型: HRESULT 成功した場合はS_OK を返します。それ以外の場合はエラー コードを返します。
解説
ハードウェア サーバーからの切断に加えて、この呼び出しは XApuConnectOutputParameters::baseData も解放し、XApuConnectOutputParameters::resultReadyEvent ハンドルを閉じます。 キューに入れられたすべてのコマンドが処理される前に XApuDisconnect が呼び出された場合、すべてのリソースを解放し、エラー コード XAPU_E_PENDING_RESULTS を返します。 XApuDisconnect を呼び出す前に、呼び出し側は最後にキューに入れられたコマンドの結果を待機する必要があります。そうしないと、ハードウェア内で重大な障害が発生し、他のアクティブな XAPU クライアントを無効にする可能性があります。 ストリームを開始および停止するために XapuConnect と XApuDisconnect を頻繁に呼び出すことはお勧めしません。これらの呼び出しは時間がかかり、メモリの断片化によりリソース損失を引き起こす可能性もあるためです。代わりに、XapuConnect はストリーミング セッションの初期化時に一度だけ呼び出し、ストリーミング中のストリームの開始と停止には XApuCommandType::Activate と XApuCommandType::Deactivate を使用する必要があります。ストリーミング セッションの終了時には XApuDisconnect を呼び出す必要があります。これはすべての XAPU クライアントに当てはまります。要件
ヘッダー: xapu.h ライブラリ: xapu.lib サポートされているプラットフォーム: XBOX Series X|S概念ドキュメント
関連項目
XApuConnectXAPU