MediaFrameSourceController.GetPropertyByExtendedIdAsync Método

Definición

Obtiene de forma asincrónica el valor de la propiedad con el identificador especificado de mediaFrameSource, utilizando un identificador extendido con información de encabezado personalizada y especificando el tamaño máximo del búfer necesario para almacenar el resultado.

public:
 virtual IAsyncOperation<MediaFrameSourceGetPropertyResult ^> ^ GetPropertyByExtendedIdAsync(Platform::Array <byte> ^ extendedPropertyId, IReference<unsigned int> ^ maxPropertyValueSize) = GetPropertyByExtendedIdAsync;
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<MediaFrameSourceGetPropertyResult> GetPropertyByExtendedIdAsync(winrt::array_view <byte> const& extendedPropertyId, IReference<uint32_t> const& maxPropertyValueSize);
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<MediaFrameSourceGetPropertyResult> GetPropertyByExtendedIdAsync(byte[] extendedPropertyId, System.Nullable<uint> maxPropertyValueSize);
function getPropertyByExtendedIdAsync(extendedPropertyId, maxPropertyValueSize)
Public Function GetPropertyByExtendedIdAsync (extendedPropertyId As Byte(), maxPropertyValueSize As Nullable(Of UInteger)) As IAsyncOperation(Of MediaFrameSourceGetPropertyResult)

Parámetros

extendedPropertyId

Byte[]

byte[]

Matriz de bytes que contiene los datos de identificador extendidos.

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

Una operación asincrónica que, tras finalizar correctamente, devuelve un objeto MediaFrameSourceGetPropertyResult que contiene el estado de la operación y, si se ejecuta correctamente, el valor de propiedad devuelto.

Atributos

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.

Se aplica a