MediaFrameSourceController.GetPropertyByExtendedIdAsync 方法

定义

命名空间:

Windows.Media.Capture.Frames

从 MediaFrameSource 异步获取具有指定 ID 的属性的值，使用具有自定义标头信息的扩展 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 访问相机属性的示例，请参阅 扩展控件和元数据示例。