다음을 통해 공유


VideoDeviceController.GetDevicePropertyByExtendedId 메서드

정의

사용자 지정 헤더 정보가 있는 확장 ID를 사용하고 결과를 저장하는 데 필요한 최대 버퍼 크기를 지정하여 캡처 디바이스 드라이버에서 지정된 ID를 가진 속성 값을 가져옵니다. 이 메서드를 사용하여 특정 카메라와 관련된 속성을 쿼리할 수 있습니다.

public:
 virtual VideoDeviceControllerGetDevicePropertyResult ^ GetDevicePropertyByExtendedId(Platform::Array <byte> ^ extendedPropertyId, IReference<unsigned int> ^ maxPropertyValueSize) = GetDevicePropertyByExtendedId;
VideoDeviceControllerGetDevicePropertyResult GetDevicePropertyByExtendedId(winrt::array_view <byte> const& extendedPropertyId, IReference<uint32_t> const& maxPropertyValueSize);
public VideoDeviceControllerGetDevicePropertyResult GetDevicePropertyByExtendedId(byte[] extendedPropertyId, System.Nullable<uint> maxPropertyValueSize);
function getDevicePropertyByExtendedId(extendedPropertyId, maxPropertyValueSize)
Public Function GetDevicePropertyByExtendedId (extendedPropertyId As Byte(), maxPropertyValueSize As Nullable(Of UInteger)) As VideoDeviceControllerGetDevicePropertyResult

매개 변수

extendedPropertyId

Byte[]

byte[]

확장 식별자 데이터를 포함하는 바이트 배열입니다.

maxPropertyValueSize

IReference<UInt32>

Nullable<UInt32>

Windows.Foundation.IReference

IReference<uint32_t>

작업 결과를 저장하기 위해 할당해야 하는 버퍼의 크기입니다. 드라이버에서 반환된 속성에 크기를 지정할 필요가 없는 경우 이 값을 null로 설정합니다. 크기가 필요하고 값을 제공하지 않으면 반환된 VideoDeviceControllerGetDevicePropertyResult 개체의 Status 속성은 MaxPropertyValueSizeRequired가 됩니다. 제공된 값이 너무 작아서 작업 결과를 저장할 수 없는 경우 반환된 Status 개체는 MaxPropertyValueSizeTooSmall이 되므로 더 큰 버퍼 크기로 호출을 다시 시도할 수 있습니다.

반환

작업의 상태 포함하는 VideoDeviceControllerGetDevicePropertyResult 개체이며, 성공하면 반환된 속성 값입니다.

Windows 요구 사항

디바이스 패밀리
Windows 10 Creators Update (10.0.15063.0에서 도입되었습니다.)
API contract
Windows.Foundation.UniversalApiContract (v4.0에서 도입되었습니다.)

설명

일반적인 디바이스 속성은 VideoDeviceController 클래스의 속성으로 노출됩니다. 추가 속성은 KSPROPERTYSETID_ExtendedCameraControl 속성 집합에 정의됩니다. 레거시 속성은 PROPSETID_VIDCAP_CAMERACONTROL 속성 집합에 정의됩니다. ID로 카메라 속성에 액세스하는 예제는 확장 컨트롤 및 메타데이터 샘플을 참조하세요.

적용 대상