BufferMediaFrame Klasse

Definition

Namespace:

Windows.Media.Capture.Frames

Stellt einen Frame aus einer MediaFrameSource dar , der Daten in einem IBuffer bereitstellt.

public ref class BufferMediaFrame sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 196608)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class BufferMediaFrame final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 196608)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class BufferMediaFrame

Public NotInheritable Class BufferMediaFrame

Vererbung

Object Platform::Object IInspectable BufferMediaFrame

Attribute

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 Anniversary Edition (eingeführt in 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v3.0)

Hinweise

Rufen Sie eine instance dieser Klasse ab, indem Sie auf die BufferMediaFrame-Eigenschaft eines MediaFrameReference-Objekts zugreifen, das von einer Medienframequelle abgerufen wurde. Die BufferMediaFrame-Eigenschaft eines MediaFrameReference-Objekts ist immer ungleich NULL. Dies gilt nicht für andere Frametypen, z. B. VideoMediaFrame, der NULL ist, wenn der Puffer keine 2D-Bilddaten enthält oder Daten in einem unbekannten Format enthält.

Ein BufferMediaFrame stellt den 1D-Puffer dar. Wenn das zugrunde liegende Beispiel, das von der Pipeline zurückgegeben wird, nicht aufeinanderfolgende Daten enthält, verwendet das System IMFMediaBuffer.Lock , um den 2D-Puffer in den 1D-Puffer zu kopieren. Aus diesem Grund wird empfohlen, BufferMediaFrame für beliebige Puffer zu verwenden, z. B. Skelett- oder Bodytrackingdaten, aber VideoMediaFrame für 2D-Puffer zu verwenden, um zusätzliche Kopiervorgänge zu vermeiden.

Anleitungen zur Verwendung von MediaFrameSource zum Erfassen von Frames finden Sie unter Verarbeiten von Medienframes mit MediaFrameReader.

Eigenschaften

Buffer	Ruft den Puffer ab, der die Daten für bufferMediaFrame enthält.
FrameReference	Ruft das MediaFrameReference-Wrapperobjekt ab, das dem BufferMediaFrame zugeordnet ist, das Zugriff auf Formatinformationen und andere Eigenschaften des Medienrahmens bietet.

Weitere Informationen

• Verarbeiten von Medienframes mit „MediaFrameReader“