MediaCapture.StartPreviewToCustomSinkAsync 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
多載
| 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
自訂媒體接收的媒體延伸模組。
傳回
物件，用來控制非同步作業。
- 屬性
Windows 需求
| 應用程式功能 |
backgroundMediaRecording
|
備註
當您呼叫 StartPreviewToCustomSinkAsync時，系統會呼叫自訂接收的 IMFMediaTypeHandler.IsMediaTypeSupported 方法，傳入擷取裝置的原生媒體類型。 這項檢查是為了避免不必要的視訊轉換而執行。 如果自訂接收在進行此檢查時從 IsMediaTypeSupported 傳回S_OK，則預覽資料流程會使用原生媒體類型，而不是 encodingProfile 參數所指定的類型。
另請參閱
適用於
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
包含媒體延伸模組的屬性。
傳回
物件，用來控制非同步作業。
- 屬性
Windows 需求
| 應用程式功能 |
backgroundMediaRecording
|
備註
當您呼叫 StartPreviewToCustomSinkAsync時，系統會呼叫自訂接收的 IMFMediaTypeHandler.IsMediaTypeSupported 方法，傳入擷取裝置的原生媒體類型。 這項檢查是為了避免不必要的視訊轉換而執行。 如果自訂接收在進行此檢查時從 IsMediaTypeSupported 傳回S_OK，則預覽資料流程會使用原生媒體類型，而不是 encodingProfile 參數所指定的類型。