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) |