KSEVENT_VPNOTIFY_FORMATCHANGE
The KSEVENT_VPNOTIFY_FORMATCHANGE event is used to propagate an event, such as a video-format change, from the kernel-mode DVD decoder minidriver to DirectShow in user-mode.
Usage Summary Table
| Get | Set | Target | Event descriptor type | Event value type |
|---|---|---|---|---|
| No | Yes | Pin | KSE_NODE | KSEVENTDATA |
The minidriver can detect a change in the video-format, for example a resolution change from 640x480 to 720x480. User-mode components must be notified of this format change so that the necessary actions can take place between DirectShow filters and KsProxy.
KsProxy's VPE filter passes a user-mode event handle (created using the Win32 API CreateEvent) via this event to the minidriver, which must save the event handle.
The minidriver later sets this event handle to notify the KsProxy VPE filter, which renegotiates the connection based on the new video format.
The KsProxy VPE filter disables the event notification by sending the IOCTL_KS_DISABLE_EVENT I/O control code with the same event handle. The event handle is then closed by the VPE filter. The minidriver must not close the event handle.
For more information about DirectShow filters and KsProxy see Kernel Streaming Proxy. For more information about handling stream changes, such as a video resolution change, see Stream Changes.
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for