VideoDeviceController.GetDevicePropertyById Método

Definição

Namespace:

Windows.Media.Devices

Obtém um valor da propriedade do driver do dispositivo de captura com a ID com informações de cabeçalho personalizadas. Você pode usar esse método para consultar propriedades específicas de uma câmera específica.

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

O identificador da propriedade para a qual o valor é recuperado.

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

VideoDeviceControllerGetDevicePropertyResult

Um objeto VideoDeviceControllerGetDevicePropertyResult que contém o status da operação e, se bem-sucedido, o valor da propriedade retornado.

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.