IPortWaveCyclic::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. Es sollte von der Interrupt-Dienstroutine des Miniporttreibers (ISR) aufgerufen werden.

Syntax

void Notify(
  [in] PSERVICEGROUP ServiceGroup
);

Parameter

[in] ServiceGroup

Zeigen Sie auf das IServiceGroup-Objekt des Miniporttreibers.

Rückgabewert

Nichts

Bemerkungen

Diese Methode ist für die genaue Anzeigedauer von entscheidender Bedeutung. Miniport-Treiber rufen diese Methode in der Regel als Reaktion auf einen Benachrichtigungsunterbruch auf, nachdem die Unterbrechungsquelle gelöscht wurde. Obwohl der Miniporttreiber frei ist, andere Methoden zu verwenden, um zu bestimmen, wann diese Methode aufgerufen werden soll, ist eine genaue Anzeigedauer wichtig und sollte beibehalten werden.

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 Porttreiber ruft die IMiniportWaveCyclicStream::SetNotificationFreq Methode auf, um die Häufigkeit anzugeben, mit der der ISR die Notify-Methode aufrufen soll. In allen aktuellen Windows-Versionen gibt der Porttreiber ein normales Intervall von 10 Millisekunden zwischen aufeinander folgenden Benachrichtigungen an. Dieser Wert kann sich in einer zukünftigen Version ändern.

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