IMemInputPin::ReceiveCanBlock-Methode (strmif.h)
[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 ReceiveCanBlock -Methode bestimmt, ob Aufrufe der IMemInputPin::Receive-Methode blockiert werden können.
Syntax
HRESULT ReceiveCanBlock();
Rückgabewert
Gibt einen HRESULT-Wert zurück. Mögliche Werte sind die in der folgenden Tabelle gezeigten Werte.
| Rückgabecode | Beschreibung |
|---|---|
|
Die Anheftung wird bei einem Anruf zum Empfangen nicht blockiert. |
|
Die Anheftung kann bei einem Aufruf von Receive blockiert werden. |
Bemerkungen
Wenn diese Methode S_FALSE zurückgibt, werden Aufrufe der Receive-Methode garantiert nicht blockiert. Andernfalls können sie blockieren. Ein Upstream Filter kann diese Methode verwenden, um seine Threadingstrategie zu bestimmen. Wenn Aufrufe von Receive blockieren können, entscheidet der Upstream Filter möglicherweise, einen Workerthread zu verwenden, der Daten puffert.
Anforderungen
| 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 |