Compartilhar via


VideoDeviceController.GetDevicePropertyByExtendedId Método

Definição

Obtém o valor da propriedade com a ID especificada do driver do dispositivo de captura, 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. Você pode usar esse método para consultar propriedades específicas de uma câmera específica.

public:
 virtual VideoDeviceControllerGetDevicePropertyResult ^ GetDevicePropertyByExtendedId(Platform::Array <byte> ^ extendedPropertyId, IReference<unsigned int> ^ maxPropertyValueSize) = GetDevicePropertyByExtendedId;
VideoDeviceControllerGetDevicePropertyResult GetDevicePropertyByExtendedId(winrt::array_view <byte> const& extendedPropertyId, IReference<uint32_t> const& maxPropertyValueSize);
public VideoDeviceControllerGetDevicePropertyResult GetDevicePropertyByExtendedId(byte[] extendedPropertyId, System.Nullable<uint> maxPropertyValueSize);
function getDevicePropertyByExtendedId(extendedPropertyId, maxPropertyValueSize)
Public Function GetDevicePropertyByExtendedId (extendedPropertyId As Byte(), maxPropertyValueSize As Nullable(Of UInteger)) As VideoDeviceControllerGetDevicePropertyResult

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

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.

Aplica-se a