Compartilhar via


Função StreamClassCallAtNewPriority (strmini.h)

O StreamClassCallAtNewPriority agenda uma rotina a ser chamada em uma prioridade diferente.

Sintaxe

VOID STREAMAPI StreamClassCallAtNewPriority(
  [in, optional] PHW_STREAM_OBJECT    StreamObject,
  [in]           PVOID                HwDeviceExtension,
  [in]           STREAM_PRIORITY      Priority,
  [in]           PHW_PRIORITY_ROUTINE PriorityRoutine,
  [in]           PVOID                Context
);

Parâmetros

[in, optional] StreamObject

Ponteiro para uma estrutura HW_STREAM_OBJECT especificando o fluxo está associado à rotina ou NULL se a rotina estiver associada ao dispositivo como um todo. Pode haver apenas uma rotina por fluxo e apenas uma rotina para o dispositivo. Esse parâmetro é opcional.

[in] HwDeviceExtension

Ponteiro para a extensão do dispositivo do minidriver. O minidriver especifica o tamanho desse buffer na estrutura HW_INITIALIZATION_DATA que ele passa quando ele se registra por meio de StreamClassRegisterMinidriver. Em seguida, o driver de classe passa ponteiros para o buffer no HwDeviceExtension membro do HW_STREAM_REQUEST_BLOCK, HW_STREAM_OBJECT, HW_TIME_CONTEXTe PORT_CONFIGURATION_INFORMATION estruturas que ele passa para o minidriver.

[in] Priority

Especifica um dos valores listados na tabela a seguir.

Prioridade Uso
Alto O driver de classe de fluxo chama a rotina com a mesma prioridade que o StrMini do minidriverxxx retornos de chamada. Não use essa configuração, a menos que a rotina seja sincronizada com a rotina de serviço de interrupção do minidriver.
Despachar O driver de classe de fluxo chama a rotina em DISPATCH_LEVEL. Use essa prioridade se a rotina levar menos de 1 milissegundo para ser concluída.
Baixo O driver de classe de fluxo chama a rotina em PASSIVE_LEVEL. Use essa prioridade se a rotina levar menos de 1 milissegundo para ser concluída.
LowToHigh Usado para permitir que um thread chamado de baixa prioridade retorne à alta prioridade para que outros serviços de driver de classe de fluxo possam ser chamados.

[in] PriorityRoutine

O ponteiro para um StrMiniPriorityRoutine fornecido pelo minidriver a ser chamado no nível de prioridade especificado.

[in] Context

Especifica o parâmetro a ser passado para o PriorityRoutine.

Valor de retorno

Nenhum

Requisitos

Requisito Valor
da Plataforma de Destino Área de trabalho
cabeçalho strmini.h (inclua Strmini.h)
biblioteca Stream.lib
IRQL (Consulte a seção Parâmetros)