MediaCapture.InitializeAsync 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
多載
InitializeAsync() |
使用預設設定,初始化 MediaCapture 物件。 |
InitializeAsync(MediaCaptureInitializationSettings) |
初始化 MediaCapture 物件。 |
InitializeAsync()
使用預設設定,初始化 MediaCapture 物件。
public:
virtual IAsyncAction ^ InitializeAsync() = InitializeAsync;
/// [Windows.Foundation.Metadata.Overload("InitializeAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncAction InitializeAsync();
[Windows.Foundation.Metadata.Overload("InitializeAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncAction InitializeAsync();
function initializeAsync()
Public Function InitializeAsync () As IAsyncAction
傳回
會傳回用來控制非同步作業的 IAsyncAction 物件。
- 屬性
Windows 需求
應用程式功能 |
backgroundMediaRecording
microphone
webcam
|
備註
InitializeAsync 會啟動同意提示,以取得應用程式存取麥克風或相機的許可權。 您應該從應用程式的主要 UI 執行緒呼叫 InitializeAsync。 在使用 C# 或 C++ 的應用程式中,第一次使用 MediaCapture 物件來呼叫 InitializeAsync 應該位於 STA 執行緒上。 來自 MTA 執行緒的呼叫可能會導致未定義的行為。
如需初始化和關閉 MediaCapture 物件的操作指南,請參閱 使用 MediaCapture 進行基本相片、視訊和音訊擷取。
從 Windows 版本 1803 開始, InitializeAsync 會傳回錯誤,或在偵測到不支援的擷取裝置時擲回錯誤碼0xC00DAFC8 (MF_E_UNSUPPORTED_CAPTURE_DEVICE_PRESENT) 例外狀況。 您可以檢查此錯誤碼,並更新 UI 以向使用者發出警示。
另請參閱
適用於
InitializeAsync(MediaCaptureInitializationSettings)
初始化 MediaCapture 物件。
public:
virtual IAsyncAction ^ InitializeAsync(MediaCaptureInitializationSettings ^ mediaCaptureInitializationSettings) = InitializeAsync;
/// [Windows.Foundation.Metadata.Overload("InitializeWithSettingsAsync")]
IAsyncAction InitializeAsync(MediaCaptureInitializationSettings const& mediaCaptureInitializationSettings);
[Windows.Foundation.Metadata.Overload("InitializeWithSettingsAsync")]
public IAsyncAction InitializeAsync(MediaCaptureInitializationSettings mediaCaptureInitializationSettings);
function initializeAsync(mediaCaptureInitializationSettings)
Public Function InitializeAsync (mediaCaptureInitializationSettings As MediaCaptureInitializationSettings) As IAsyncAction
參數
- mediaCaptureInitializationSettings
- MediaCaptureInitializationSettings
初始化設定。
傳回
會傳回用來控制非同步作業的 IAsyncAction 物件。
- 屬性
Windows 需求
應用程式功能 |
backgroundMediaRecording
microphone
webcam
|
備註
InitializeAsync 會啟動同意提示,以取得應用程式存取麥克風或相機的許可權。 您應該從應用程式的主要 UI 執行緒呼叫 InitializeAsync。 在使用 C# 或 C++ 的應用程式中,第一次使用 MediaCapture 物件來呼叫 InitializeAsync 應該位於 STA 執行緒上。 來自 MTA 執行緒的呼叫可能會導致未定義的行為。
如需初始化和關閉 MediaCapture 物件的操作指南,請參閱 使用 MediaCapture 進行基本相片、視訊和音訊擷取。
從 Windows 版本 1803 開始, InitializeAsync 會傳回錯誤,或在偵測到不支援的擷取裝置時擲回錯誤碼0xC00DAFC8 (MF_E_UNSUPPORTED_CAPTURE_DEVICE_PRESENT) 例外狀況。 您可以檢查此錯誤碼,並更新 UI 以向使用者發出警示。