IPortWavePci::Notify-Methode (portcls.h)

Artikel
02/07/2025

Mit der Notify-Methode wird der Porttreiber benachrichtigt, dass ein Interrupt 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

Nichts

Bemerkungen

Einige Miniporttreiber rufen diese Methode von einem 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. Grundsätzlich sollten nur Treiber, die einen einzelnen Renderdatenstrom von KMixer verwalten, hardwareunterbricht. Treiber, die die DirectSound-Hardwarebeschleunigung unterstützen, sollten stattdessen Hardwareunterbrechungen deaktivieren und Timer-DPCs verwenden. Weitere Informationen finden Sie unter IPortWavePciStream::GetMapping.

Obwohl der Miniporttreiber frei ist, eine eigene Technik für die Ermittlung des Aufrufs dieser Methode zu wählen, sollte diese Methode häufig genug aufgerufen werden, damit der Porttreiber ausstehende Position und Taktereignisse in regelmäßigen Abständen auslösen kann. Die Anzeigedauer für diese Methode ist nicht so wichtig wie für die IPortWaveCyclic::Notify-Methode.

Wenn ein Adaptertreiber einen ISR installiert, sendet 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 den ISR auf und übergibt ServiceContext als Aufrufparameter an den ISR. Obwohl die Bedeutung des ServiceContext Parameter nur für den Treiberentwickler bekannt ist, handelt es sich in der Regel um einen Zeiger auf das Miniportobjekt. Der ISR verwendet diesen Zeiger, um auf Informationen zum Miniport-Objekt zuzugreifen.

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