VideoDeviceController.GetDevicePropertyByExtendedId Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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
-
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.