IPortWavePci::Notify-Methode (portcls.h)

Artikel
02/26/2024

Die Notify -Methode benachrichtigt den Porttreiber, dass ein Interrupt aufgetreten ist, der den Fortschritt des DMA-Zeigers angibt.

Syntax

void Notify(
  [in] PSERVICEGROUP ServiceGroup
);

Parameter

[in] ServiceGroup

Ein Zeiger auf das IServiceGroup-Objekt des Miniporttreibers.

Rückgabewert

Keine

Bemerkungen

Einige Miniporttreiber rufen diese Methode von einer ISR als Reaktion auf einen Hardwareunterbrechung auf, nachdem die Interruptquelle gelöscht wurde. Andere Treiber rufen diese Methode von einem Timer-DPC auf, der in regelmäßigen Abständen ausgeführt werden soll. In der Regel sollten nur Treiber, die einen einzelnen Renderdatenstrom von KMixer verwalten, Hardwareunterbrechungen verwenden. Treiber, die die DirectSound-Hardwarebeschleunigung unterstützen, sollten Hardwareunterbrechungen deaktivieren und stattdessen Timer-DPCs verwenden. Weitere Informationen finden Sie unter IPortWavePciStream::GetMapping.

Obwohl der Miniporttreiber seine eigene Technik zum Bestimmen des Aufrufs dieser Methode wählen kann, sollte diese Methode häufig genug aufgerufen werden, damit der Porttreiber in regelmäßigen Abständen ausstehende Positions- und Uhrereignisse auslösen kann. Das Timing für diese Methode ist jedoch nicht so wichtig wie für die IPortWaveCyclic::Notify-Methode .

Wenn ein Adaptertreiber eine ISR installiert, übermittelt er einen ServiceContext-Parameter zusammen mit dem Einstiegspunkt des ISR (Ausführliche Informationen finden Sie unter Bereitstellen von ISR-Kontextinformationen). Wenn der Interrupt auftritt, ruft das Betriebssystem die ISR auf und übergibt ServiceContext als Aufrufparameter an die ISR. Obwohl die Bedeutung des ServiceContext-Parameters nur dem Treiberentwickler bekannt ist, handelt es sich in der Regel um einen Zeiger auf das Miniport-Objekt. Die ISR verwendet diesen Zeiger, um auf Informationen zum Miniportobjekt zuzugreifen.

Der ServiceGroup-Parameter folgt den Referenzzählungskonventionen für COM-Objekte.