VideoDeviceController.GetDevicePropertyByExtendedId 方法

定义

命名空间:

Windows.Media.Devices

从捕获设备驱动程序获取具有指定 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

一个 VideoDeviceControllerGetDevicePropertyResult 对象，其中包含操作的状态，如果成功，则返回的属性值。

Windows 要求

设备系列	Windows 10 Creators Update (在 10.0.15063.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v4.0 中引入)

注解

常见的设备属性作为 VideoDeviceController 类的属性公开。 其他属性在 KSPROPERTYSETID_ExtendedCameraControl 属性集中定义。 旧属性在 PROPSETID_VIDCAP_CAMERACONTROL 属性集中定义。 有关按 ID 访问相机属性的示例，请参阅 扩展控件和元数据示例。