VideoDeviceController.GetDevicePropertyById Metodo

Definizione

Spazio dei nomi:

Windows.Media.Devices

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

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

VideoDeviceControllerGetDevicePropertyResult

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.