IMediaSample2::GetProperties-Methode (strmif.h)

  • Artikel

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Die GetProperties -Methode ruft die Eigenschaften eines Medienbeispiels ab.

Syntax

HRESULT GetProperties(
  [in]  DWORD cbProperties,
  [out] BYTE  *pbProperties
);

Parameter

[in] cbProperties

Länge der abzurufenden Eigenschaftsdaten in Bytes.

[out] pbProperties

Zeiger auf einen Puffer der Größe cbProperties.

Rückgabewert

Gibt einen HRESULT-Wert zurück. Die folgenden Werte sind möglich.

Rückgabecode BESCHREIBUNG
S_OK
 Erfolg.
E_POINTER
 NULL-Zeigerargument.

Hinweise

Die abgerufenen Daten entsprechen dem Format der AM_SAMPLE2_PROPERTIES-Struktur . Sie können eine Teilmenge der Beispieleigenschaften abrufen, indem Sie cbProperties auf einen Wert festlegen, der kleiner als die Größe der AM_SAMPLE2_PROPERTIES-Struktur ist.

Aus Gründen der Effizienz ist das in AM_SAMPLE2_PROPERTIES zurückgegebene pMediaType-Member ein Zeiger auf die im Medienbeispiel gespeicherten Daten, nicht eine Kopie dieser Daten. Der Zeiger kann ungültig werden, nachdem das Beispiel an einen anderen Filter übergeben wurde oder nachdem die IMemInputPin::Receive-Methode des Eingabenadels abgeschlossen wurde. Geben Sie außerdem den Zeiger nicht frei, oder löschen Sie den Medientyp nicht.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile strmif.h (include Dshow.h)
Bibliothek Strmiids.lib

Weitere Informationen

Fehler- und Erfolgscodes

IMediaSample2-Schnittstelle