VideoDeviceController.GetDevicePropertyById Método

Definición

Espacio de nombres:

Windows.Media.Devices

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 VideoDeviceControllerGetDevicePropertyResult

Parámetros

propertyId

String

Platform::String

winrt::hstring

Identificador de la propiedad para la que se recupera el valor.

maxPropertyValueSize

IReference<UInt32>

Nullable<UInt32>

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

VideoDeviceControllerGetDevicePropertyResult

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.