VideoDeviceController.GetDevicePropertyByExtendedId Метод

Определение

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

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

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