VideoDeviceController.GetDevicePropertyById Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft den Wert der -Eigenschaft vom Capture-Gerätetreiber mit der ID mit benutzerdefinierten Headerinformationen ab. Sie können diese Methode verwenden, um Eigenschaften abzufragen, die für eine bestimmte Kamera spezifisch sind.
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
Parameter
- propertyId
-
String
Platform::String
winrt::hstring
Der Bezeichner der Eigenschaft, für die der Wert abgerufen wird.
- maxPropertyValueSize
-
Windows.Foundation.IReference
IReference<uint32_t>
Die Größe des Puffers, der zugeordnet werden soll, um das Ergebnis des Vorgangs zu speichern. Wenn für den Treiber keine Größe für die zurückgegebene Eigenschaft angegeben werden muss, legen Sie diesen Wert auf NULL fest. Wenn die Größe erforderlich ist und Sie keinen Wert angeben, lautet die Status-Eigenschaft des zurückgegebenen VideoDeviceControllerGetDevicePropertyResult-ObjektsMaxPropertyValueSizeRequired. Wenn der angegebene Wert zu klein ist, um das Ergebnis des Vorgangs zu speichern, lautet das zurückgegebene Status-ObjektMaxPropertyValueSizeTooSmall, was bedeutet, dass Sie den Aufruf mit einer größeren Puffergröße wiederholen können.
Gibt zurück
Ein VideoDeviceControllerGetDevicePropertyResult-Objekt, das die status des Vorgangs und bei erfolgreicher Ausführung den zurückgegebenen Eigenschaftswert enthält.
Windows-Anforderungen
Gerätefamilie |
Windows 10 Creators Update (eingeführt in 10.0.15063.0)
|
API contract |
Windows.Foundation.UniversalApiContract (eingeführt in v4.0)
|
Hinweise
Allgemeine Geräteeigenschaften werden als Eigenschaften der VideoDeviceController-Klasse verfügbar gemacht. Zusätzliche Eigenschaften werden im KSPROPERTYSETID_ExtendedCameraControl Eigenschaftensatz definiert. Legacyeigenschaften werden im PROPSETID_VIDCAP_CAMERACONTROL Eigenschaftensatz definiert. Ein Beispiel für den Zugriff auf Kameraeigenschaften nach ID finden Sie im Beispiel für erweiterte Steuerelemente und Metadaten.