Método IMiniportWaveCyclicStream::SetNotificationFreq (portcls.h)

Artigo
02/29/2024

O SetNotificationFreq método controla a frequência com que as interrupções de notificação são geradas definindo o intervalo entre interrupções sucessivas.

Sintaxe

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

Parâmetros

[in] Interval

Especifica o intervalo entre interrupções de notificação. Esse valor de parâmetro é expresso em milissegundos.

[out] FrameSize

Ponteiro de saída para o tamanho do quadro. Esse parâmetro aponta para uma variável alocada pelo chamador na qual o método grava o número máximo de bytes que podem ser transferidos em milissegundos interval . Essa contagem de bytes determina o tamanho do buffer que precisa ser alocado para o fluxo de entrada ou saída.

Retornar valor

SetNotificationFreq retorna o novo intervalo de notificação expresso em milissegundos. Em todas as versões atuais do Windows, o driver de porta ignora esse valor.

Comentários

Durante cada interrupção de notificação, a rotina de serviço de interrupção do driver de miniport chama o método IPortWaveCyclic::Notify com o objeto IServiceGroup do fluxo como o parâmetro de chamada. Esse é o objeto IServiceGroup que o driver de miniporto gera anteriormente para o driver de porta durante a chamada IMiniportWaveCyclic::NewStream .

Em todas as versões atuais do Windows, o driver de porta WaveCyclic especifica um valor interval de 10 milissegundos. Esse valor pode mudar em versões futuras.