MediaCapture.CaptureDeviceExclusiveControlStatusChanged イベント
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
キャプチャ デバイスの排他制御状態が変更されたときに発生します。
// 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 を更新して、別のアプリがキャプチャ デバイスの設定を調整する可能性があることをユーザーに警告することができます。