이벤트 알림 코드

[이 페이지와 연결된 기능인 DirectShow는 레거시 기능입니다. MediaPlayer, IMFMediaEngine 및 Media Foundation의 오디오/비디오 캡처로 대체되었습니다. 이러한 기능은 Windows 10 및 Windows 11 최적화되었습니다. 가능한 경우 새 코드에서 DirectShow 대신 MediaPlayer, IMFMediaEngine 및 오디오/비디오 캡처를 사용하는 것이 좋습니다. 가능한 경우 레거시 API를 사용하는 기존 코드를 다시 작성하여 새 API를 사용하도록 제안합니다.]

이 섹션에서는 DVD와 관련이 없는 DirectShow 이벤트를 나열합니다. DVD와 관련된 이벤트는 DVD 이벤트 알림 코드를 참조하세요.

필터는 IMediaEventSink::Notify 메서드를 호출하여 필터 그래프 관리자로 이벤트를 보냅니다. Filter Graph Manager는 일부 이벤트를 처리하고 애플리케이션에 대해 다른 이벤트를 큐에 대기합니다. 애플리케이션은 IMediaEvent::GetEvent 메서드를 호출하여 검색합니다.

다음 섹션에서 각 항목에는 이벤트 코드, 이벤트 매개 변수의 의미 및 이벤트에 대한 Graph 관리자 필터링의 기본 작업(있는 경우)이 나열됩니다. 기본 작업을 재정의하려면 IMediaEvent::CancelDefaultHandling을 호출합니다. 이벤트 코드는 헤더 파일 Evcode.h 및 Audevcod.h에 정의됩니다. 기본 작업이 없는 경우 Filter Graph Manager는 이벤트 큐를 통해 애플리케이션에 이벤트를 자동으로 전달합니다.

사용자 지정 이벤트

필터는 EC_USER 이상의 범위에서 이벤트 코드를 사용하여 사용자 지정 이벤트를 정의할 수 있습니다. 필터 그래프 관리자는 이벤트 큐에 직접 배치합니다. 그러나 다음 주의 사항이 적용됩니다.

• Filter Graph Manager는 일반 IMediaEvent::FreeEventParams 메서드를 사용하여 이벤트 매개 변수를 해제할 수 없습니다. 애플리케이션은 이벤트 매개 변수와 연결된 모든 메모리 또는 참조 수를 해제해야 합니다.
• 필터는 이벤트를 처리할 준비가 된 애플리케이션 내에서만 이벤트를 보내야 합니다. (애플리케이션이 필터에서 사용자 지정 속성을 설정하여 이벤트를 안전하게 보낼 수 있음을 나타낼 수 있습니다.)

이벤트 알림 코드	Description
EC_ACTIVATE	비디오 창이 활성화되거나 비활성화되고 있습니다.
EC_BANDWIDTHCHANGE	지원되지 않습니다.
EC_BUFFERING_DATA	그래프가 데이터를 버퍼링하거나 데이터 버퍼링을 중지했습니다.
EC_BUILT	그래프가 작성되었을 때 Video Control에서 보냅니다. 애플리케이션에 전달되지 않습니다.
EC_CLOCK_CHANGED	참조 클록이 변경되었습니다.
EC_CLOCK_UNSET	클록 공급자의 연결이 끊어졌습니다.
EC_CODECAPI_EVENT	인코더에서 인코딩 이벤트를 신호로 보냅니다.
EC_COMPLETE	특정 스트림의 모든 데이터가 렌더링되었습니다.
EC_CONTENTPROPERTY_CHANGED	지원되지 않습니다.
EC_DEVICE_LOST	플러그 앤 플레이 디바이스가 제거되었거나 다시 사용할 수 있게 되었습니다.
EC_DISPLAY_CHANGED	디스플레이 모드가 변경되었습니다.
EC_END_OF_SEGMENT	세그먼트의 끝에 도달했습니다.
EC_EOS_SOON	지원되지 않습니다.
EC_ERROR_STILLPLAYING	그래프를 실행하는 비동기 명령이 실패했습니다.
EC_ERRORABORT	오류로 인해 작업이 중단되었습니다.
EC_ERRORABORTEX	오류로 인해 작업이 중단되었습니다.
EC_EXTDEVICE_MODE_CHANGE	지원되지 않습니다.
EC_FILE_CLOSED	예기치 않은 이벤트로 인해 원본 파일이 닫혔습니다.
EC_FULLSCREEN_LOST	비디오 렌더러가 전체 화면 모드에서 전환되고 있습니다.
EC_GRAPH_CHANGED	필터 그래프가 변경되었습니다.
EC_LENGTH_CHANGED	원본의 길이가 변경되었습니다.
EC_LOADSTATUS	네트워크 파일을 열 때 애플리케이션에 진행 상황을 알 수 있습니다.
EC_MARKER_HIT	지원되지 않습니다.
EC_NEED_RESTART	필터가 그래프를 다시 시작하라는 요청입니다.
EC_NEW_PIN	지원되지 않습니다.
EC_NOTIFY_WINDOW	비디오 렌더러 창의 필터에 알립니다.
EC_OLE_EVENT	필터가 텍스트 문자열을 애플리케이션에 전달합니다.
EC_OPENING_FILE	그래프가 파일을 열거나 파일 열기를 완료했습니다.
EC_PALETTE_CHANGED	비디오 팔레트가 변경되었습니다.
EC_PAUSED	일시 중지 요청이 완료되었습니다.
EC_PLEASE_REOPEN	원본 파일이 변경되었습니다.
EC_PREPROCESS_COMPLETE	멀티패스 인코딩을 위한 사전 처리를 완료할 때 WM ASF 기록 기 필터에서 전송됩니다.
EC_PROCESSING_LATENCY	구성 요소가 각 샘플을 처리하는 데 걸리는 시간을 나타냅니다.
EC_QUALITY_CHANGE	그래프는 품질 관리를 위해 샘플을 삭제하고 있습니다.
EC_RENDER_FINISHED	지원되지 않습니다.
EC_REPAINT	비디오 렌더러에는 다시 그려야 합니다.
EC_SAMPLE_LATENCY	구성 요소가 샘플 처리를 위한 일정보다 훨씬 뒤처지는 정도를 지정합니다.
EC_SAMPLE_NEEDED	EVR(고급 비디오 렌더러) 필터에서 새 입력 샘플을 요청합니다.
EC_SCRUB_TIME	가장 최근 프레임 단계의 타임스탬프를 지정합니다.
EC_SEGMENT_STARTED	새 세그먼트가 시작되었습니다.
EC_SHUTTING_DOWN	필터 그래프는 삭제되기 전에 종료됩니다.
EC_SNDDEV_IN_ERROR	오디오 캡처 필터에서 디바이스 오류가 발생했습니다.
EC_SNDDEV_OUT_ERROR	오디오 렌더러 필터에서 디바이스 오류가 발생했습니다.
EC_STARVATION	필터가 충분한 데이터를 받지 못하고 있습니다.
EC_STATE_CHANGE	필터 그래프의 상태가 변경되었습니다.
EC_STATUS	두 개의 임의 상태 문자열을 포함합니다.
EC_STEP_COMPLETE	프레임 스테핑을 수행하는 필터가 지정된 수의 프레임을 밟았습니다.
EC_STREAM_CONTROL_STARTED	스트림 제어 시작 명령이 적용되었습니다.
EC_STREAM_CONTROL_STOPPED	스트림 제어 중지 명령이 적용되었습니다.
EC_STREAM_ERROR_STILLPLAYING	스트림에서 오류가 발생했습니다. 스트림이 여전히 재생되고 있습니다.
EC_STREAM_ERROR_STOPPED	오류로 인해 스트림이 중지되었습니다.
EC_TIMECODE_AVAILABLE	지원되지 않습니다.
EC_UNBUILT	그래프가 삭제된 경우 비디오 컨트롤에서 보냅니다. 애플리케이션에 전달되지 않습니다.
EC_USERABORT	사용자가 재생을 종료했습니다.
EC_VIDEO_SIZE_CHANGED	네이티브 비디오 크기가 변경되었습니다.
EC_VIDEOFRAMEREADY	비디오 프레임을 표시할 준비가 된 것입니다.
EC_VMR_RECONNECTION_FAILED	업스트림 디코더에서 동적 형식 변경 요청을 수락할 수 없는 경우 VMR-7 및 VMR-9에서 전송됩니다.
EC_VMR_RENDERDEVICE_SET	VMR이 렌더링 메커니즘을 선택한 경우 전송됩니다.
EC_VMR_SURFACE_FLIPPED	VMR-7의 할당자 발표자가 표시되는 표면에서 DirectDraw Flip 메서드를 호출했을 때 전송됩니다.
EC_WINDOW_DESTROYED	비디오 렌더러가 그래프에서 제거되거나 제거되었습니다.
EC_WMT_EVENT	WM ASF 판독기 필터가 DRM(디지털 권한 관리)으로 보호되는 ASF 파일을 읽을 때 전송됩니다.
EC_WMT_INDEX_EVENT	애플리케이션이 WM ASF 기록기를 사용하여 Windows Media Video 파일을 인덱싱할 때 전송됩니다.

 

관련 항목

상수 및 GUID

DirectShow의 이벤트 알림