IMiniportWaveCyclicStream::SetNotificationFreq-Methode (portcls.h)

Artikel
02/26/2024

Die SetNotificationFreq -Methode steuert die Häufigkeit, mit der Benachrichtigungsunterbrechungen generiert werden, indem das Intervall zwischen aufeinander folgenden Interrupts festgelegt wird.

Syntax

ULONG SetNotificationFreq(
  [in]  ULONG  Interval,
  [out] PULONG FrameSize
);

Parameter

[in] Interval

Gibt das Intervall zwischen Benachrichtigungsunterbrechungen an. Dieser Parameterwert wird in Millisekunden ausgedrückt.

[out] FrameSize

Ausgabezeiger für die Framegröße. Dieser Parameter verweist auf eine vom Aufrufer zugeordnete Variable, in die die Methode die maximale Anzahl von Bytes schreibt, die in Millisekunden übertragen werden können. Diese Byteanzahl bestimmt die Größe des Puffers, der für den Eingabe- oder Ausgabestream zugeordnet werden muss.

Rückgabewert

SetNotificationFreq gibt das neue Benachrichtigungsintervall in Millisekunden zurück. In allen aktuellen Windows-Versionen ignoriert der Porttreiber diesen Wert.

Hinweise

Während jeder Benachrichtigungsunterbrechung ruft die Interruptdienstroutine des Miniporttreibers die IPortWaveCyclic::Notify-Methode mit dem IServiceGroup-Objekt des Datenstroms als Aufrufparameter auf. Dies ist das IServiceGroup-Objekt , das der Miniporttreiber zuvor während des IMiniportWaveCyclic::NewStream-Aufrufs an den Porttreiber ausgegeben hat.

In allen aktuellen Windows-Releases gibt der WaveCyclic-Porttreiber einen Intervallwert von 10 Millisekunden an. Dieser Wert kann sich in zukünftigen Releases ändern.