VideoDeviceController.GetDevicePropertyById 方法

定义

命名空间:

Windows.Media.Devices

使用具有自定义标头信息的 ID 从捕获设备驱动程序获取 属性的值。 可以使用此方法查询特定于特定相机的属性。

public:
 virtual VideoDeviceControllerGetDevicePropertyResult ^ GetDevicePropertyById(Platform::String ^ propertyId, IReference<unsigned int> ^ maxPropertyValueSize) = GetDevicePropertyById;

VideoDeviceControllerGetDevicePropertyResult GetDevicePropertyById(winrt::hstring const& propertyId, IReference<uint32_t> const& maxPropertyValueSize);

public VideoDeviceControllerGetDevicePropertyResult GetDevicePropertyById(string propertyId, System.Nullable<uint> maxPropertyValueSize);

function getDevicePropertyById(propertyId, maxPropertyValueSize)

Public Function GetDevicePropertyById (propertyId As String, maxPropertyValueSize As Nullable(Of UInteger)) As VideoDeviceControllerGetDevicePropertyResult

参数

propertyId

String

Platform::String

winrt::hstring

要为其检索值的属性的标识符。

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 访问相机属性的示例，请参阅 扩展控件和元数据示例。