MediaFrameSourceController.GetPropertyByExtendedIdAsync 메서드

정의

네임스페이스:

Windows.Media.Capture.Frames

사용자 지정 헤더 정보가 있는 확장 ID를 사용하고 결과를 저장하는 데 필요한 최대 버퍼 크기를 지정하여 MediaFrameSource에서 지정된 ID를 사용하여 속성의 값을 비동기적으로 가져옵니다.

public:
 virtual IAsyncOperation<MediaFrameSourceGetPropertyResult ^> ^ GetPropertyByExtendedIdAsync(Platform::Array <byte> ^ extendedPropertyId, IReference<unsigned int> ^ maxPropertyValueSize) = GetPropertyByExtendedIdAsync;

/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<MediaFrameSourceGetPropertyResult> GetPropertyByExtendedIdAsync(winrt::array_view <byte> const& extendedPropertyId, IReference<uint32_t> const& maxPropertyValueSize);

[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<MediaFrameSourceGetPropertyResult> GetPropertyByExtendedIdAsync(byte[] extendedPropertyId, System.Nullable<uint> maxPropertyValueSize);

function getPropertyByExtendedIdAsync(extendedPropertyId, maxPropertyValueSize)

Public Function GetPropertyByExtendedIdAsync (extendedPropertyId As Byte(), maxPropertyValueSize As Nullable(Of UInteger)) As IAsyncOperation(Of MediaFrameSourceGetPropertyResult)

매개 변수

extendedPropertyId

Byte[]

byte[]

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

maxPropertyValueSize

IReference<UInt32>

Nullable<UInt32>

Windows.Foundation.IReference

IReference<uint32_t>

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

반환

IAsyncOperation<MediaFrameSourceGetPropertyResult>

성공적으로 완료되면 작업의 상태 포함하는 MediaFrameSourceGetPropertyResult 개체를 반환하고, 성공하면 반환된 속성 값을 반환하는 비동기 작업입니다.

특성

RemoteAsyncAttribute

Windows 요구 사항

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

설명

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