Kódy oznámení událostí
[Funkce přidružená k této stránce DirectShow je starší funkce. Byla nahrazena MediaPlayer, MMFMediaEnginea Audio/Video Capture v Media Foundation. Tyto funkce jsou optimalizované pro Windows 10 a Windows 11. Microsoft důrazně doporučuje, aby nový kód používal MediaPlayer, MMFMediaEngine a Audio/Video Capture v Media Foundation místo DirectShow, pokud je to možné. Microsoft navrhuje, aby se stávající kód, který používá starší rozhraní API, přepsal, aby se nová rozhraní API používala, pokud je to možné.]
V této části jsou uvedeny události DirectShow, které nejsou specifické pro DISK DVD. Informace o událostech specifických pro DISK DVD naleznete v tématu kódy oznámení o událostech DVD.
Filtry odesílají události do Správce grafů filtru voláním metody IMediaEventSink::Notify. Správce grafů filtru zpracovává některé události a zařadí jiné do fronty pro aplikaci. Aplikace je načte voláním metody IMediaEvent::GetEvent.
V následujících částech uvádí každá položka kód události, význam parametrů události a výchozí akci Filter Graph Manageru pro událost( pokud existuje). Chcete-li přepsat výchozí akci, volání IMediaEvent::CancelDefaultHandling. Kódy událostí jsou definovány v hlavičkových souborech Evcode.h a Audevcod.h. Pokud neexistuje žádná výchozí akce, Správce grafů filtru událost automaticky předá aplikaci (prostřednictvím fronty událostí).
vlastních událostí
Filtry mohou definovat vlastní události s kódy událostí v rozsahu EC_USER a vyšší. Správce grafů filtru je umístí přímo do fronty událostí. Platí však následující upozornění:
- Správce grafů filtru nemůže uvolnit parametry události pomocí normální IMediaEvent::FreeEventParams metoda. Aplikace musí uvolnit všechny počty paměti nebo odkazů přidružené k parametrům události.
- Filtr by měl odeslat událost pouze z aplikace, která je připravená na zpracování události. (Aplikace může ve filtru nastavit vlastní vlastnost, která indikuje, že je bezpečné odeslat událost.)
Kód oznámení události | Popis |
---|---|
EC_ACTIVATE | Aktivuje se nebo deaktivuje okno videa. |
EC_BANDWIDTHCHANGE | Nepodporuje se. |
EC_BUFFERING_DATA | Graf ukládání dat do vyrovnávací paměti nebo přestal ukládat data do vyrovnávací paměti. |
EC_BUILT | Odeslání ovládacím prvku video při vytvoření grafu Nepřeposlané aplikacím. |
EC_CLOCK_CHANGED | Referenční hodiny se změnily. |
EC_CLOCK_UNSET | Zprostředkovatel hodin byl odpojen. |
EC_CODECAPI_EVENT | Odešle kodér, aby signalizoval událost kódování. |
EC_COMPLETE | Všechna data z konkrétního datového proudu se vykreslují. |
EC_CONTENTPROPERTY_CHANGED | Nepodporuje se. |
EC_DEVICE_LOST | Zařízení Plug and Play bylo odebráno nebo bylo znovu k dispozici. |
EC_DISPLAY_CHANGED | Režim zobrazení se změnil. |
EC_END_OF_SEGMENT | Bylo dosaženo konce segmentu. |
EC_EOS_SOON | Nepodporuje se. |
EC_ERROR_STILLPLAYING | Asynchronní příkaz ke spuštění grafu se nezdařil. |
EC_ERRORABORT | Operace byla přerušena kvůli chybě. |
EC_ERRORABORTEX | Operace byla přerušena kvůli chybě. |
EC_EXTDEVICE_MODE_CHANGE | Nepodporuje se. |
EC_FILE_CLOSED | Zdrojový soubor byl zavřený kvůli neočekávané události. |
EC_FULLSCREEN_LOST | Renderer videa se přepíná z režimu celé obrazovky. |
EC_GRAPH_CHANGED | Graf filtru se změnil. |
EC_LENGTH_CHANGED | Délka zdroje se změnila. |
EC_LOADSTATUS | Upozorní aplikaci průběhu při otevření síťového souboru. |
EC_MARKER_HIT | Nepodporuje se. |
EC_NEED_RESTART | Filtr požaduje restartování grafu. |
EC_NEW_PIN | Nepodporuje se. |
EC_NOTIFY_WINDOW | Upozorní filtr okna rendereru videa. |
EC_OLE_EVENT | Filtr předává aplikaci textový řetězec. |
EC_OPENING_FILE | Graf otevírá soubor nebo dokončil otevření souboru. |
EC_PALETTE_CHANGED | Paleta videí se změnila. |
EC_PAUSED | Žádost o pozastavení byla dokončena. |
EC_PLEASE_REOPEN | Zdrojový soubor se změnil. |
EC_PREPROCESS_COMPLETE | Po dokončení předběžného zpracování pro kódování multipassu WM ASF Writer filtr. |
EC_PROCESSING_LATENCY | Označuje dobu, po kterou komponenta zpracovává jednotlivé vzorky. |
EC_QUALITY_CHANGE | Graf vyhazuje vzorky pro kontrolu kvality. |
EC_RENDER_FINISHED | Nepodporuje se. |
EC_REPAINT | Renderer videa vyžaduje překreslení. |
EC_SAMPLE_LATENCY | Určuje, jak daleko za plánem je komponenta pro zpracování vzorků. |
EC_SAMPLE_NEEDED | Vyžádá si novou ukázku vstupu z filtru Enhanced Video Renderer (EVR). |
EC_SCRUB_TIME | Určuje časové razítko posledního kroku rámce. |
EC_SEGMENT_STARTED | Spustil se nový segment. |
EC_SHUTTING_DOWN | Graf filtru se před zničením vypne. |
EC_SNDDEV_IN_ERROR | Ve filtru záznamu zvuku došlo k chybě zařízení. |
EC_SNDDEV_OUT_ERROR | Ve filtru zvukového rendereru došlo k chybě zařízení. |
EC_STARVATION | Filtr nepřijímá dostatek dat. |
EC_STATE_CHANGE | Graf filtru změnil stav. |
EC_STATUS | Obsahuje dva libovolné stavové řetězce. |
EC_STEP_COMPLETE | Filtr provádějící krokování rámce stupňovil zadaný počet snímků. |
EC_STREAM_CONTROL_STARTED | Projevil se spouštěcí příkaz pro řízení datových proudů. |
EC_STREAM_CONTROL_STOPPED | Projevil se příkaz zastavení řízení datových proudů. |
EC_STREAM_ERROR_STILLPLAYING | Ve streamu došlo k chybě. Stream se pořád přehrává. |
EC_STREAM_ERROR_STOPPED | Datový proud se zastavil kvůli chybě. |
EC_TIMECODE_AVAILABLE | Nepodporuje se. |
EC_UNBUILT | Odeslání ovládacím prvku video, když byl graf odtrhnut. Nepřeposlané aplikacím. |
EC_USERABORT | Uživatel ukončil přehrávání. |
EC_VIDEO_SIZE_CHANGED | Velikost nativního videa se změnila. |
EC_VIDEOFRAMEREADY | Rámeček videa je připravený k zobrazení. |
EC_VMR_RECONNECTION_FAILED | Odeslalo ho VMR-7 a VMR-9, když nebylo možné přijmout požadavek na změnu dynamického formátu z upstreamového dekodéru. |
EC_VMR_RENDERDEVICE_SET | Odesláno, když VMR vybral svůj mechanismus vykreslování. |
EC_VMR_SURFACE_FLIPPED | Odesláno, když prezentující alokátorU VMR-7 volal metodu DirectDraw Flip na povrchu, který se prezentuje. |
EC_WINDOW_DESTROYED | Renderer videa byl zničen nebo odebrán z grafu. |
EC_WMT_EVENT | Odesílaný filtrem WM ASF Reader při čtení souborů ASF chráněných správou digitálních práv (DRM). |
EC_WMT_INDEX_EVENT | Odesláno, když aplikace používá WM ASF Writer k indexování souborů Windows Media Video. |
Související témata
-
Oznámení události v DirectShow