VideoDeviceController.GetDevicePropertyById Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene un valor de la propiedad del controlador de dispositivo de captura con el identificador con información de encabezado personalizada. Puede usar este método para consultar propiedades específicas de una cámara determinada.
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 VideoDeviceControllerGetDevicePropertyResultParámetros
- propertyId
-
String
Platform::String
winrt::hstring
Identificador de la propiedad para la que se recupera el valor.
- maxPropertyValueSize
-
Windows.Foundation.IReference
IReference<uint32_t>
Tamaño del búfer que se debe asignar para almacenar el resultado de la operación. Si el controlador no requiere que se especifique un tamaño para la propiedad devuelta, establezca este valor en NULL. Si se requiere el tamaño y no se proporciona un valor, la propiedad Status del objeto VideoDeviceControllerGetDevicePropertyResult devuelto será MaxPropertyValueSizeRequired. Si el valor proporcionado es demasiado pequeño para almacenar el resultado de la operación, el objeto Status devuelto será MaxPropertyValueSizeTooSmall, lo que significa que puede volver a intentar la llamada con un tamaño de búfer mayor.
Devoluciones
Objeto VideoDeviceControllerGetDevicePropertyResult que contiene el estado de la operación y, si se ejecuta correctamente, el valor de propiedad devuelto.
Requisitos de Windows
| Familia de dispositivos |
Windows 10 Creators Update (se introdujo en la versión 10.0.15063.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (se introdujo en la versión v4.0)
|
Comentarios
Las propiedades comunes del dispositivo se exponen como propiedades de la clase VideoDeviceController . Las propiedades adicionales se definen en el conjunto de propiedades KSPROPERTYSETID_ExtendedCameraControl . Las propiedades heredadas se definen en el conjunto de propiedades PROPSETID_VIDCAP_CAMERACONTROL . Para obtener un ejemplo de acceso a las propiedades de la cámara por identificador, consulte el ejemplo de control extendido y metadatos.