Поделиться через


VideoDeviceController.GetDevicePropertyById Метод

Определение

Возвращает значение свойства из драйвера устройства захвата с идентификатором с пользовательскими сведениями заголовка. Этот метод можно использовать для запроса свойств, относящихся к определенной камере.

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. Если размер является обязательным и значение не указано, свойство Status возвращаемого объекта VideoDeviceControllerGetDevicePropertyResult будет иметь значение 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 . Пример доступа к свойствам камеры по идентификатору см. в примере расширенных элементов управления и метаданных.

Применяется к