Compartir a través de

Función StreamClassCallAtNewPriority (strmini.h)

  • Artículo

La StreamClassCallAtNewPriority programa una rutina a la que se llamará con una prioridad diferente.

Sintaxis

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

Puntero a una estructura de HW_STREAM_OBJECT que especifica que la secuencia está asociada a la rutina o NULL si la rutina está asociada al dispositivo en su conjunto. Solo puede haber una rutina por secuencia y solo una rutina para el dispositivo. Este parámetro es opcional.

[in] HwDeviceExtension

Puntero a la extensión del dispositivo del minidriver. El minidriver especifica el tamaño de este búfer en la estructura HW_INITIALIZATION_DATA que pasa cuando se registra a sí mismo a través de StreamClassRegisterMinidriver. A continuación, el controlador de clase pasa punteros al búfer de la HwDeviceExtension miembro del HW_STREAM_REQUEST_BLOCK, HW_STREAM_OBJECT, HW_TIME_CONTEXTy PORT_CONFIGURATION_INFORMATION estructuras que pasa al minidriver.

[in] Priority

Especifica uno de los valores enumerados en la tabla siguiente.

Prioridad Uso
Alto El controlador de clase de secuencia llama a la rutina con la misma prioridad que las devoluciones de llamada de StrMiniXxx del minidriver. No use esta configuración a menos que la rutina se deba sincronizar con la rutina del servicio de interrupción del minidriver.
Envío El controlador de clase de secuencia llama a la rutina en DISPATCH_LEVEL. Use esta prioridad si la rutina tarda menos de 1 milisegundos en completarse.
Bajo El controlador de clase de secuencia llama a la rutina en PASSIVE_LEVEL. Use esta prioridad si la rutina tarda menos de 1 milisegundos en completarse.
LowToHigh Se usa para permitir que un subproceso denominado de prioridad baja vuelva a la prioridad alta para que se pueda llamar a otros servicios de controladores de clase de secuencia.

[in] PriorityRoutine

Puntero a un minidriver proporcionado StrMiniPriorityRoutine que se llamará en el nivel de prioridad especificado.

[in] Context

Especifica el parámetro que se va a pasar al PriorityRoutine.

Valor devuelto

Ninguno

Requisitos

Requisito Valor
de la plataforma de destino de Escritorio
encabezado de strmini.h (incluya Strmini.h)
biblioteca de Stream.lib
irQL (Consulte la sección Parámetros)