VideoDeviceController.GetDevicePropertyById 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 un valore della proprietà dal driver di dispositivo di acquisizione con l'ID con informazioni di intestazione personalizzate. È possibile usare questo metodo per eseguire query su proprietà specifiche di una particolare fotocamera.
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
Parametri
- propertyId
-
String
Platform::String
winrt::hstring
Identificatore della proprietà per cui viene recuperato il valore.
- 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.