Handling Power Management Events

[This is preliminary documentation and subject to change.]

Systems that implement advanced power management or the Advanced Configuration and Power Interface (ACPI) cause Windows 98 to request that the video server and controls suspend operation when the system goes to sleep. Your application should handle the Video control's power management events so it does not attempt to access the Video control or devices while they are unavailable.

When the video server receives a suspend request from the power management system it releases all devices and destroys the filter graph. Each instance of the Video control sends a BPCVid.Power event, specifying PBT_APMQUERYSUSPEND. Applications should not call the Video control or devices until they receive one of the following values in a subsequent Power event: PBT_APMQUERYSUSPENDFAILED, PBT_APMRESUMEAUTOMATIC, or PBT_APMRESUMESUSPEND. At this time, your application can resume use of the Video control and server. Because the filter graph was rebuilt, your application must reenumerate devices and refresh any device information it had stored.

If the value returned in the Power event is PBT_APMQUERYSUSPENDFAILED the system did not suspend, because another application refused the suspend request.