IMFCameraControlDefaultsCollection::GetOrAddExtendedControl 메서드(mfidl.h)

카메라 컨트롤 컬렉션에 새로운 확장 카메라 컨트롤을 추가합니다.

구문

HRESULT GetOrAddExtendedControl(
  [in]  MF_CAMERA_CONTROL_CONFIGURATION_TYPE configType,
  [in]  ULONG                                constrolId,
  [in]  DWORD                                streamId,
  [in]  ULONG                                dataSize,
  [out] IMFCameraControlDefaults             **defaults
);

매개 변수

[in] configType

스트리밍이 시작되기 전에 또는 스트리밍이 시작된 후 컨트롤 값을 설정해야 하는지 여부를 지정하는 MF_CAMERA_CONTROL_CONFIGURATION_TYPE 값입니다.

[in] constrolId

컬렉션에 추가할 컨트롤의 ID입니다. 이 값은 KSPROPERTYSETID_ExtendedCameraControl 속성 집합의 ID여야 합니다.

[in] streamId

컨트롤과 연결된 스트림의 ID입니다. 이 매개 변수는 핀 수준 컨트롤에만 사용됩니다. 그렇지 않으면 이 값이 무시됩니다.

[in] dataSize

컨트롤의 데이터 페이로드 크기(바이트)입니다.

[out] defaults

추가된 컨트롤을 나타내는 IMFCameraControlDefaults instance 대한 포인터를 받습니다.

반환 값

다음을 포함한 HRESULT:

값	설명
S_OK	성공.
MF_E_INVALIDREQUEST	지정한 컨트롤 ID가 KSPROPERTYSETID_ExtendedCameraControl 속성 집합에 없습니다.

설명

데이터 페이로드 크기는 컨트롤마다 다를 수 있습니다. 컨트롤이 필요한 버퍼를 예약할 수 있도록 dataSize 값은 컨트롤 페이로드 스키마에 대해 유효해야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 11 빌드 22621
지원되는 최소 서버	Windows 11 빌드 22621
머리글	mfidl.h