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를 사용하여 디바이스 방향 처리를 참조하세요.