Compartir a través de

Función StreamClassCallAtNewPriority (strmini.h)

  • Artículo

La rutina 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 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 en el miembro HwDeviceExtension del HW_STREAM_REQUEST_BLOCK, HW_STREAM_OBJECT, HW_TIME_CONTEXT y PORT_CONFIGURATION_INFORMATION estructuras que pasa al minidriver.

[in] Priority

Especifica uno de los valores enumerados en la tabla siguiente.

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

[in] PriorityRoutine

Puntero a una minidriver proporcionada por StrMiniPriorityRoutine que se llamará en el nivel de prioridad especificado.

[in] Context

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

Valor devuelto

None

Requisitos

Requisito Value
Plataforma de destino Escritorio
Encabezado strmini.h (include Strmini.h)
Library Stream.lib
IRQL (Consulte la sección Parámetros)