IMFSampleGrabberSinkCallback2::OnProcessSampleEx-Methode (mfidl.h)

Artikel
08/24/2023

Wird aufgerufen, wenn die Sample-Grabber-Senke ein neues Medienbeispiel empfängt.

Syntax

HRESULT OnProcessSampleEx(
  [in] REFGUID       guidMajorMediaType,
  [in] DWORD         dwSampleFlags,
  [in] LONGLONG      llSampleTime,
  [in] LONGLONG      llSampleDuration,
  [in] const BYTE    *pSampleBuffer,
  [in] DWORD         dwSampleSize,
  [in] IMFAttributes *pAttributes
);

Parameter

[in] guidMajorMediaType

Die Haupttyp-GUID, die das Format der Daten angibt. Eine Liste der möglichen Werte finden Sie unter Hauptmedientypen.

[in] dwSampleFlags

Beispielflags. Die Sample-Grabber-Senke ruft den Wert dieses Parameters ab, indem die IMFSample::GetSampleFlags-Methode des Medienbeispiels aufgerufen wird.

[in] llSampleTime

Die Präsentationszeit für dieses Beispiel in 100 Nanosekundeneinheiten. Wenn das Beispiel keine Präsentationszeit aufweist, ist der Wert dieses Parameters _I64_MAX

[in] llSampleDuration

Die Dauer der Probe in 100 Nanosekundeneinheiten.

Wenn das Beispiel keine Dauer aufweist, wird der Wert dieses Parameters _I64_MAX.

[in] pSampleBuffer

Ein Zeiger auf einen Puffer, der die Beispieldaten enthält.

[in] dwSampleSize

Die Größe des pSampleBuffer-Puffers in Bytes.

[in] pAttributes

Ein Zeiger auf die IMFAttributes-Schnittstelle . Verwenden Sie diese Schnittstelle, um die Attribute für dieses Beispiel abzurufen (falls vorhanden). Eine Liste der Beispielattribute finden Sie unter Beispielattribute.

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Wenn Sie die Beispielgrabbersenke in einer Wiedergabetopologie verwenden, sollte diese Methode schnell zurückgegeben werden, da sonst die Wiedergabe beeinträchtigt wird. Blockieren Sie den Thread nicht, warten Sie nicht auf Ereignisse oder führen Sie andere langwierige Vorgänge innerhalb dieser Methode aus.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	mfidl.h

Weitere Informationen

IMFSampleGrabberSinkCallback2

Freigeben über