Implementering av IPowerNotify

Om din drivrutins miniport-objekt (se Gränssnitt för ljudminiportobjekt) eller strömobjekt (se Audio Stream Object Interfaces) behöver känna till ändringar i energispartillståndet kan de stödja IPowerNotify-gränssnittet i sina QueryInterface-metoder och ta emot meddelanden från PortCls-systemdrivrutinen varje gång en strömändring sker.

När energitillståndet ändras anropar PortCls metoden IPowerNotify::PowerChangeNotify för att meddela var och en av miniport- och strömobjekten som stöder IPowerNotify-gränssnittet. Under PowerChangeNotify-anropet ska ett miniportobjekt cachelagrat det nya enhetskrafttillståndet. Under CAdapterCommon::Init-anropet (se till exempel implementeringen i Msvad-exempelkortet i Microsoft Windows Driver Kit [WDK]) bör miniportdrivrutinen ange sitt cachelagrade energitillstånd till det ursprungliga värdet PowerDeviceD0.

Innan du anropar PowerChangeState för att slå av anropar PortCls IPowerNotify::PowerChangeNotify för att ge miniportdrivrutinen möjlighet att spara all nödvändig enhetskontext. Den här kontexten kan till exempel innehålla de maskinvaruregistervärden som förkroppsligar den aktuella filtertopologin och mixerradsinställningarna. När du har anropat PowerChangeState för att starta anropar PortCls PowerChangeNotify så att miniportdrivrutinen kan återställa den sparade kontexten.

När du stänger av pausar PortCls alla aktiva ljuddataströmmar innan du anropar PowerChangeNotify. Vid uppstart anropar PortCls PowerChangeNotify innan du startar om pausade ljuddataströmmar.

Miniportdrivrutinens klasser för miniport och strömobjekt kan ärva från IPowerNotify-gränssnittet och stödja detta gränssnitt i deras NonDelegatingQueryInterface-metod. Du kan använda IMP_IPowerNotify definition från huvudfilen Portcls.h för att lägga till funktionsdeklarationen för powerchangeNotify-metoden i klassdefinitionen för drivrutinens miniport- och strömobjekt.