MediaCapture.CaptureDeviceExclusiveControlStatusChanged 事件

定义

命名空间:

Windows.Media.Capture

当捕获设备的独占控制状态更改时发生。

// Register
event_token CaptureDeviceExclusiveControlStatusChanged(TypedEventHandler<MediaCapture, MediaCaptureDeviceExclusiveControlStatusChangedEventArgs const&> const& handler) const;

// Revoke with event_token
void CaptureDeviceExclusiveControlStatusChanged(event_token const* cookie) const;

// Revoke with event_revoker
MediaCapture::CaptureDeviceExclusiveControlStatusChanged_revoker CaptureDeviceExclusiveControlStatusChanged(auto_revoke_t, TypedEventHandler<MediaCapture, MediaCaptureDeviceExclusiveControlStatusChangedEventArgs const&> const& handler) const;

public event TypedEventHandler<MediaCapture,MediaCaptureDeviceExclusiveControlStatusChangedEventArgs> CaptureDeviceExclusiveControlStatusChanged;

function onCaptureDeviceExclusiveControlStatusChanged(eventArgs) { /* Your code */ }
mediaCapture.addEventListener("capturedeviceexclusivecontrolstatuschanged", onCaptureDeviceExclusiveControlStatusChanged);
mediaCapture.removeEventListener("capturedeviceexclusivecontrolstatuschanged", onCaptureDeviceExclusiveControlStatusChanged);
- or -
mediaCapture.oncapturedeviceexclusivecontrolstatuschanged = onCaptureDeviceExclusiveControlStatusChanged;

Public Custom Event CaptureDeviceExclusiveControlStatusChanged As TypedEventHandler(Of MediaCapture, MediaCaptureDeviceExclusiveControlStatusChangedEventArgs) 

事件类型

TypedEventHandler<MediaCapture,MediaCaptureDeviceExclusiveControlStatusChangedEventArgs>

Windows 要求

设备系列	Windows 10 Creators Update (在 10.0.15063.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v4.0 中引入)
应用功能	backgroundMediaRecording

注解

当应用对捕获设备具有独占控制权时，它可以修改设备的设置。 对捕获设备没有独占控制权的应用仍然可以捕获媒体，但无法更改捕获设置。 通过在将结构传递到 InitializeAsync 之前将 MediaCaptureInitializationSettings.SharingMode 属性设置为 ExclusiveControl 来请求独占控制。 如果在另一个应用已具有对设备的独占访问权限时请求独占控制，则对 InitializeAsync 的调用将失败。 在这种情况下，可以侦听 CaptureDeviceExclusiveControlStatusChanged，如果 MediaCaptureDeviceExclusiveControlStatusChangedEventArgs.Status 的值为 ExclusiveControlAvailable，则可以尝试使用独占控件重新初始化 MediaCapture 。

如果引发 CaptureDeviceExclusiveControlStatusChanged 事件，并且 MediaCaptureDeviceExclusiveControlStatusChangedEventArgs.Status 的值为 SharedReadOnlyAvailable，则另一个应用已获取设备的独占控制权。 在这种情况下，你可能想要更新 UI 以提醒用户另一个应用可能会调整捕获设备设置。