XApuDisconnect
从硬件服务器断开连接,并释放在 XApuConnect 期间分配的所有资源。Syntax
Parameters
handle _In_Type: XApuHandle 通过调用 XApuConnect 返回的句柄。
Return value
Type: HRESULT 如果成功,则返回S_OK;否则,返回错误代码。
Remarks
除了与硬件服务器断开连接之外,此调用还将释放 XApuConnectOutputParameters::baseData 并关闭 XApuConnectOutputParameters::resultReadyEvent 句柄。 如果在所有已排队命令处理完毕之前调用 XApuDisconnect,它将释放所有资源并返回此错误代码 XAPU_E_PENDING_RESULTS。 调用方必须在调用 XApuDisconnect 之前等待最后一个入队命令的结果,否则硬件中可能会发生灾难性故障,从而禁用其他活动的 XAPU 客户端。 不建议频繁调用 XapuConnect 和 XApuDisconnect 来启动和停止流,因为这些调用非常耗时,并且可能由于内存碎片而导致资源丢失。相反,应在流会话初始化时调用一次 XapuConnect,然后在流传输过程中使用 XApuCommandType::Activate 和 XApuCommandType::Deactivate 来启动和停止流。在流会话结束时,应调用 XApuDisconnect。所有 XAPU 客户端均适用。Requirements
头文件: xapu.h 库: xapu.lib 支持的平台: XBOX Series X|SConceptual documentation
See also
XApuConnectXAPU