IAdapterPnpManagement::P npStop-Methode (portcls.h)

Die PnpStop-Methode stellt eine Benachrichtigung bereit, nachdem alle Ioctl-Vorgänge beendet und aktive Streams aus dem Zustand run|pause|acquire verschoben werden, um den Zustand zu beenden.

Syntax

void PnpStop();

Rückgabewert

Keine

Bemerkungen

PnpStop wird von Portcls aufgerufen, nachdem alle Ioctl-Vorgänge beendet und aktive Datenströme aus dem Zustand run|pause|acquire verschoben wurden, um den Zustand zu beenden. Dieser Aufruf erfolgt nicht, während die globale Sperre des Geräts gedrückt wird. Daher hat der Miniporttreiber die Möglichkeit, auf seine asynchronen Vorgänge (Arbeitselemente, dpc, asynchrone Threads) zu warten und die Registrierung seiner Audiountergeräte aufzuheben. Vor der Rückgabe von diesem Aufruf muss der Miniport sicherstellen, dass alle Hardwareressourcen freigegeben wurden.

Der Miniport darf nicht warten, bis die aktuellen Miniport-/Stream-Objekte gelöscht werden, da unklar ist, wann vorhandene Audioclients die aktuellen Handles freigeben. Der PnpStop-Thread kann nicht ewig blockiert werden, ohne das System abstürzen zu müssen, d. h. dies ist ein PnP/Power-Thread.

IAdapterPnpManagement::P npstop wird nach aufgerufen:

  • Alle Miniport-Audiountergeräte wurden benachrichtigt.
  • Alle Streams, die zu den Audiounterfunktionen gehören, wurden beendet.
  • Alle Pnp-Schnittstellen wurden deaktiviert.
  • Alle ausstehenden E/A-Vorgänge wurden abgebrochen.

Weitere Informationen finden Sie unter Implementieren eines PnP-Ausgleichs für PortCls-Audiotreiber.

Anforderungen

Anforderung Wert
Header portcls.h
IRQL PASSIVE_LEVEL

Weitere Informationen

IAdapterPnpManagement