MediaFrameSourceController.GetPropertyByExtendedIdAsync Methode

Definition

Namespace:

Windows.Media.Capture.Frames

Ruft asynchron den Wert der Eigenschaft mit der angegebenen ID aus einer MediaFrameSource ab, wobei eine erweiterte ID mit benutzerdefinierten Headerinformationen verwendet und die maximale Puffergröße angegeben wird, die zum Speichern des Ergebnisses erforderlich ist.

public:
 virtual IAsyncOperation<MediaFrameSourceGetPropertyResult ^> ^ GetPropertyByExtendedIdAsync(Platform::Array <byte> ^ extendedPropertyId, IReference<unsigned int> ^ maxPropertyValueSize) = GetPropertyByExtendedIdAsync;

/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<MediaFrameSourceGetPropertyResult> GetPropertyByExtendedIdAsync(winrt::array_view <byte> const& extendedPropertyId, IReference<uint32_t> const& maxPropertyValueSize);

[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<MediaFrameSourceGetPropertyResult> GetPropertyByExtendedIdAsync(byte[] extendedPropertyId, System.Nullable<uint> maxPropertyValueSize);

function getPropertyByExtendedIdAsync(extendedPropertyId, maxPropertyValueSize)

Public Function GetPropertyByExtendedIdAsync (extendedPropertyId As Byte(), maxPropertyValueSize As Nullable(Of UInteger)) As IAsyncOperation(Of MediaFrameSourceGetPropertyResult)

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 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

IAsyncOperation<MediaFrameSourceGetPropertyResult>

Ein asynchroner Vorgang, der nach erfolgreichem Abschluss ein MediaFrameSourceGetPropertyResult-Objekt zurückgibt, das die status des Vorgangs und bei Erfolgreicher Ausführung den zurückgegebenen Eigenschaftswert enthält.

Attribute

RemoteAsyncAttribute

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.