Metodo IMiniportWaveCyclicStream::SetNotificationFreq (portcls.h)

Articolo
02/26/2024

Il SetNotificationFreq metodo controlla la frequenza con cui vengono generati interrupt di notifica impostando l'intervallo tra interrupt successivi.

Sintassi

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

Parametri

[in] Interval

Specifica l'intervallo tra le interruzioni di notifica. Questo valore del parametro è espresso in millisecondi.

[out] FrameSize

Puntatore di output per le dimensioni del frame. Questo parametro punta a una variabile allocata dal chiamante in cui il metodo scrive il numero massimo di byte che possono essere trasferiti in millisecondi di intervallo . Questo conteggio di byte determina le dimensioni del buffer da allocare per il flusso di input o di output.

Valore restituito

SetNotificationFreq restituisce il nuovo intervallo di notifica espresso in millisecondi. In tutte le versioni correnti di Windows, il driver di porta ignora questo valore.

Commenti

Durante ogni interrupt di notifica, la routine del servizio interrupt del driver miniport chiama il metodo IPortWaveCyclic::Notify con l'oggetto IServiceGroup del flusso come parametro di chiamata. Si tratta dell'oggetto IServiceGroup restituito in precedenza dal driver miniport al driver di porta durante la chiamata IMiniportWaveCyclic::NewStream .

In tutte le versioni correnti di Windows, il driver di porta WaveCyclic specifica un valore Interval di 10 millisecondi. Questo valore potrebbe cambiare nelle versioni future.