IMiniportWaveCyclicStream::SetNotificationFreq-Methode (portcls.h)
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.
Anforderungen
Anforderung | Wert |
---|---|
Zielplattform | Universell |
Header | portcls.h (portcls.h einschließen) |
IRQL | PASSIVE_LEVEL |