VideoDeviceController.GetDevicePropertyByExtendedId Metodo

Definizione

Ottiene il valore della proprietà con l'ID specificato dal driver di dispositivo di acquisizione, usando un ID esteso con informazioni di intestazione personalizzate e specificando la dimensione massima del buffer necessaria per archiviare il risultato. È possibile usare questo metodo per eseguire query su proprietà specifiche di una particolare fotocamera.

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

Parametri

extendedPropertyId

Byte[]

byte[]

Matrice di byte contenente i dati dell'identificatore esteso.

maxPropertyValueSize

IReference<UInt32>

Nullable<UInt32>

Windows.Foundation.IReference

IReference<uint32_t>

Dimensioni del buffer da allocare per archiviare il risultato dell'operazione. Se il driver non richiede che venga specificata una dimensione per la proprietà restituita, impostare questo valore su Null. Se le dimensioni sono obbligatorie e non si specifica un valore, la proprietà Status dell'oggetto VideoDeviceControllerGetDevicePropertyResult restituito sarà MaxPropertyValueSizeRequired. Se il valore specificato è troppo piccolo per archiviare il risultato dell'operazione, l'oggetto Status restituito sarà MaxPropertyValueSizeTooSmall, il che significa che è possibile ritentare la chiamata con dimensioni del buffer maggiori.

Restituisce

Oggetto VideoDeviceControllerGetDevicePropertyResult contenente lo stato dell'operazione e, in caso di esito positivo, il valore della proprietà restituito.

Requisiti Windows

Famiglia di dispositivi
Windows 10 Creators Update (è stato introdotto in 10.0.15063.0)
API contract
Windows.Foundation.UniversalApiContract (è stato introdotto in v4.0)

Commenti

Le proprietà comuni del dispositivo vengono esposte come proprietà della classe VideoDeviceController . Le proprietà aggiuntive vengono definite nel set di proprietà KSPROPERTYSETID_ExtendedCameraControl . Le proprietà legacy vengono definite nel set di proprietà PROPSETID_VIDCAP_CAMERACONTROL . Per un esempio di accesso alle proprietà della fotocamera in base all'ID, vedere l'esempio di controllo esteso e metadati.

Si applica a