BufferMediaFrame Klasse

Definition

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

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.

Gilt für:

Weitere Informationen