MediaCapture.CaptureDeviceExclusiveControlStatusChanged イベント

定義

キャプチャ デバイスの排他制御状態が変更されたときに発生します。

// 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) 

イベントの種類

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 を更新して、別のアプリがキャプチャ デバイスの設定を調整する可能性があることをユーザーに警告することができます。

適用対象