MediaFrameSourceController.GetPropertyByExtendedIdAsync Método

Definição

Namespace:

Windows.Media.Capture.Frames

Obtém de forma assíncrona o valor da propriedade com a ID especificada de um MediaFrameSource, usando uma ID estendida com informações de cabeçalho personalizadas e especificando o tamanho máximo do buffer necessário para armazenar o 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[]

Uma matriz de bytes que contém os dados do identificador estendido.

maxPropertyValueSize

IReference<UInt32>

Nullable<UInt32>

Windows.Foundation.IReference

IReference<uint32_t>

O tamanho do buffer que deve ser alocado para armazenar o resultado da operação. Se o driver não exigir que um tamanho seja especificado para a propriedade retornada, defina esse valor como nulo. Se o tamanho for necessário e você não fornecer um valor, a propriedade Status do objeto VideoDeviceControllerGetDevicePropertyResult retornado será MaxPropertyValueSizeRequired. Se o valor fornecido for muito pequeno para armazenar o resultado da operação, o objeto Status retornado será MaxPropertyValueSizeTooSmall, o que significa que você pode repetir a chamada com um tamanho de buffer maior.

Retornos

IAsyncOperation<MediaFrameSourceGetPropertyResult>

Uma operação assíncrona que, após a conclusão bem-sucedida, retorna um objeto MediaFrameSourceGetPropertyResult que contém o status da operação e, se bem-sucedido, o valor da propriedade retornado.

Atributos

RemoteAsyncAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 Creators Update (introduzida na 10.0.15063.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v4.0)

Comentários

As propriedades comuns do dispositivo são expostas como propriedades da classe VideoDeviceController . Propriedades adicionais são definidas no conjunto de propriedades KSPROPERTYSETID_ExtendedCameraControl . As propriedades herdadas são definidas no conjunto de propriedades PROPSETID_VIDCAP_CAMERACONTROL . Para obter um exemplo de como acessar as propriedades da câmera por ID, consulte o exemplo de Controle Estendido e Metadados.