Compartilhar via

Função StreamClassCallAtNewPriority (strmini.h)

  • Artigo

A rotina StreamClassCallAtNewPriority agenda uma rotina a ser chamada com 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 de dispositivo do minidriver. O minidriver especifica o tamanho desse buffer na estrutura HW_INITIALIZATION_DATA que ele passa quando se registra por meio de StreamClassRegisterMinidriver. Em seguida, o driver de classe passa ponteiros para o buffer no membro HwDeviceExtension do HW_STREAM_REQUEST_BLOCK, HW_STREAM_OBJECT, HW_TIME_CONTEXT e 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 os retornos de chamada StrMiniXxx do minidriver. Não use essa configuração, a menos que a rotina precise ser sincronizada com a rotina de serviço de interrupção do minidriver.
Dispatch O driver da 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

Ponteiro para uma StrMiniPriorityRoutine fornecida por minidriver a ser chamada no nível de prioridade especificado.

[in] Context

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

Retornar valor

Nenhum

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho strmini.h (inclua Strmini.h)
Biblioteca Stream.lib
IRQL (Consulte a seção Parâmetros)