VideoDeviceController.GetDevicePropertyByExtendedId Methode

Definition

Namespace:

Windows.Media.Devices

Ruft den Wert der Eigenschaft mit der angegebenen ID aus dem Erfassungsgerätetreiber ab, wobei eine erweiterte ID mit benutzerdefinierten Headerinformationen verwendet wird und die maximale Puffergröße angegeben wird, die zum Speichern des Ergebnisses erforderlich ist. Sie können diese Methode verwenden, um Eigenschaften abzufragen, die für eine bestimmte Kamera spezifisch sind.

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

Parameter

extendedPropertyId

Byte[]

byte[]

Ein Bytearray, das die erweiterten Bezeichnerdaten enthält.

maxPropertyValueSize

IReference<UInt32>

Nullable<UInt32>

Windows.Foundation.IReference

IReference<uint32_t>

Die Größe des Puffers, der zugewiesen 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

VideoDeviceControllerGetDevicePropertyResult

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-Eigenschaftssatz definiert. Legacyeigenschaften werden im PROPSETID_VIDCAP_CAMERACONTROL-Eigenschaftssatz definiert. Ein Beispiel für den Zugriff auf Kameraeigenschaften nach ID finden Sie im Beispiel für erweiterte Steuerelemente und Metadaten.