MediaCapture.InitializeAsync 方法

  • 參考

定義

命名空間:
Windows.Media.Capture

多載

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

會傳回用來控制非同步作業的 IAsyncAction 物件。

屬性
OverloadAttribute RemoteAsyncAttribute

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

會傳回用來控制非同步作業的 IAsyncAction 物件。

屬性
OverloadAttribute

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 以向使用者發出警示。

另請參閱

適用於