MediaCapture.SetEncoderProperty(MediaStreamType, Guid, Object) メソッド

定義

名前空間:

Windows.Media.Capture

エンコード プロパティを設定します。

public:
 virtual void SetEncoderProperty(MediaStreamType mediaStreamType, Platform::Guid propertyId, Platform::Object ^ propertyValue) = SetEncoderProperty;

void SetEncoderProperty(MediaStreamType const& mediaStreamType, winrt::guid const& propertyId, IInspectable const& propertyValue);

public void SetEncoderProperty(MediaStreamType mediaStreamType, Guid propertyId, object propertyValue);

function setEncoderProperty(mediaStreamType, propertyId, propertyValue)

Public Sub SetEncoderProperty (mediaStreamType As MediaStreamType, propertyId As Guid, propertyValue As Object)

パラメーター

mediaStreamType

MediaStreamType

ストリームが表すメディア データの種類 (ビデオやオーディオなど)。

propertyId

Guid

Platform::Guid

winrt::guid

設定するエンコード プロパティ。

propertyValue

Object

Platform::Object

IInspectable

エンコード プロパティの新しい値。

Windows の要件

アプリの機能

backgroundMediaRecording microphone webcam

注釈

エンコーダー プロパティがレコード シンク内のオーディオ エンコーダーにのみ適用されている場合、MediaStreamType が MediaStreamType.Audio と等しい SetEncoderProperty のみを呼び出すことができます。 プレビュー シンクでは、圧縮オーディオを使用してエンコード プロファイルを設定することはできません。

H.264 以外のカメラの場合、記録またはプレビューを開始する前に SetEncoderProperty を呼び出すと、 プロパティはローカルに格納されます。 記録を開始すると、エンコーダーの初期化時に エンコーダーに プロパティが適用されます。 静的エンコード プロパティを構成するには、記録またはプレビューを開始する前に SetEncoderProperty を呼び出す必要があります。 記録またはプレビューを開始する前に、 GetEncoderProperty はローカルに格納されているプロパティの値を返します。

カメラが H.264 カメラで、SetEncoderProperty が呼び出されるストリームが MediaStreamType.VideoRecord 型の場合、プロパティはカメラに直接適用されます。 これは、記録が開始される前と後の両方に当てはまります。

H.264 以外のカメラの場合、レコードまたはプレビューの開始完了コールバックを取得した後に SetEncoderProperty を呼び出すと、プロパティはエンコーダーで直接設定されるため、動的エンコード プロパティを構成するために使用されます。

SetEncoderProperty を呼び出して記録またはプレビューを開始する呼び出しを発行した後、レコードまたはプレビューの開始完了コールバックを取得する前に、 プロパティを静的または動的な設定に適用できないため、 MF_E_INVALIDREQUEST エラーが発生します。

プレビュー ストリームをローテーションするには、MF_MT_VIDEO_ROTATIONとして定義されている GUID を使用します。 カメラを使用するときの向きの処理方法のガイダンスについては、「 MediaCapture を使用してデバイスの向きを処理する」を参照してください。