MediaCapture.StartPreviewToCustomSinkAsync 方法

定義

命名空間:

Windows.Media.Capture

多載

StartPreviewToCustomSinkAsync(MediaEncodingProfile, IMediaExtension)	使用指定的編碼設定檔，開始將預覽資料流程傳送至自訂媒體接收。
StartPreviewToCustomSinkAsync(MediaEncodingProfile, String, IPropertySet)	使用指定的編碼設定檔和接收設定，開始將預覽資料流程傳送至自訂媒體接收。

StartPreviewToCustomSinkAsync(MediaEncodingProfile, IMediaExtension)

使用指定的編碼設定檔，開始將預覽資料流程傳送至自訂媒體接收。

public:
 virtual IAsyncAction ^ StartPreviewToCustomSinkAsync(MediaEncodingProfile ^ encodingProfile, IMediaExtension ^ customMediaSink) = StartPreviewToCustomSinkAsync;

/// [Windows.Foundation.Metadata.Overload("StartPreviewToCustomSinkAsync")]
IAsyncAction StartPreviewToCustomSinkAsync(MediaEncodingProfile const& encodingProfile, IMediaExtension const& customMediaSink);

[Windows.Foundation.Metadata.Overload("StartPreviewToCustomSinkAsync")]
public IAsyncAction StartPreviewToCustomSinkAsync(MediaEncodingProfile encodingProfile, IMediaExtension customMediaSink);

function startPreviewToCustomSinkAsync(encodingProfile, customMediaSink)

Public Function StartPreviewToCustomSinkAsync (encodingProfile As MediaEncodingProfile, customMediaSink As IMediaExtension) As IAsyncAction

參數

encodingProfile

MediaEncodingProfile

用於錄製的編碼設定檔。

customMediaSink

IMediaExtension

自訂媒體接收的媒體延伸模組。

傳回

IAsyncAction

物件，用來控制非同步作業。

屬性

OverloadAttribute

Windows 需求

應用程式功能

backgroundMediaRecording

備註

當您呼叫 StartPreviewToCustomSinkAsync時，系統會呼叫自訂接收的 IMFMediaTypeHandler.IsMediaTypeSupported 方法，傳入擷取裝置的原生媒體類型。 這項檢查是為了避免不必要的視訊轉換而執行。 如果自訂接收在進行此檢查時從 IsMediaTypeSupported 傳回S_OK，則預覽資料流程會使用原生媒體類型，而不是 encodingProfile 參數所指定的類型。

另請參閱

• StartPreviewToCustomSinkAsync(MediaEncodingProfile, String, IPropertySet)

StartPreviewToCustomSinkAsync(MediaEncodingProfile, String, IPropertySet)

使用指定的編碼設定檔和接收設定，開始將預覽資料流程傳送至自訂媒體接收。

public:
 virtual IAsyncAction ^ StartPreviewToCustomSinkAsync(MediaEncodingProfile ^ encodingProfile, Platform::String ^ customSinkActivationId, IPropertySet ^ customSinkSettings) = StartPreviewToCustomSinkAsync;

/// [Windows.Foundation.Metadata.Overload("StartPreviewToCustomSinkIdAsync")]
IAsyncAction StartPreviewToCustomSinkAsync(MediaEncodingProfile const& encodingProfile, winrt::hstring const& customSinkActivationId, IPropertySet const& customSinkSettings);

[Windows.Foundation.Metadata.Overload("StartPreviewToCustomSinkIdAsync")]
public IAsyncAction StartPreviewToCustomSinkAsync(MediaEncodingProfile encodingProfile, string customSinkActivationId, IPropertySet customSinkSettings);

function startPreviewToCustomSinkAsync(encodingProfile, customSinkActivationId, customSinkSettings)

Public Function StartPreviewToCustomSinkAsync (encodingProfile As MediaEncodingProfile, customSinkActivationId As String, customSinkSettings As IPropertySet) As IAsyncAction

參數

encodingProfile

MediaEncodingProfile

用於錄製的編碼設定檔。

customSinkActivationId

String

Platform::String

winrt::hstring

自訂媒體接收之媒體延伸模組的可啟用類別識別碼。

customSinkSettings

IPropertySet

包含媒體延伸模組的屬性。

傳回

IAsyncAction

物件，用來控制非同步作業。

屬性

OverloadAttribute

Windows 需求

應用程式功能

backgroundMediaRecording

備註

當您呼叫 StartPreviewToCustomSinkAsync時，系統會呼叫自訂接收的 IMFMediaTypeHandler.IsMediaTypeSupported 方法，傳入擷取裝置的原生媒體類型。 這項檢查是為了避免不必要的視訊轉換而執行。 如果自訂接收在進行此檢查時從 IsMediaTypeSupported 傳回S_OK，則預覽資料流程會使用原生媒體類型，而不是 encodingProfile 參數所指定的類型。

另請參閱

• StartPreviewToCustomSinkAsync(MediaEncodingProfile, IMediaExtension)