Freigeben über


VideoDeviceController.GetDevicePropertyById Methode

Definition

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

IReference<UInt32>

Nullable<UInt32>

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.

Gilt für: