Поделиться через

Функция StreamClassCallAtNewPriority (strmini.h)

  • Статья

StreamClassCallAtNewPriority планирует вызывать подпрограмму по другому приоритету.

Синтаксис

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

Параметры

[in, optional] StreamObject

Указатель на структуру HW_STREAM_OBJECT, указывающую поток, связанную с подпрограммой, или NULL, если подпрограмма связана с устройством в целом. Для каждого потока может быть только одна подпрограмма и только одна подпрограмма для устройства. Этот параметр является необязательным.

[in] HwDeviceExtension

Указатель на расширение устройства minidriver. Мини-driver задает размер этого буфера в структуре HW_INITIALIZATION_DATA, которая передается при регистрации через StreamClassRegisterMinidriver. Затем драйвер класса передает указатели на буфер в HwDeviceExtension член HW_STREAM_REQUEST_BLOCK, HW_STREAM_OBJECT, HW_TIME_CONTEXTи PORT_CONFIGURATION_INFORMATION структурирует его в мини-driver.

[in] Priority

Указывает одно из значений, перечисленных в следующей таблице.

Приоритет Употребление
Высокий Драйвер класса stream вызывает подпрограмму в том же приоритете, что и обратные вызовы StrMini StrMiniXxx. Не используйте этот параметр, если подпрограмма не должна быть синхронизирована с подпрограммой прерывания мини-driver.
Отправка Драйвер класса потока вызывает подпрограмму в DISPATCH_LEVEL. Используйте этот приоритет, если подпрограмма занимает менее 1 миллисекунда.
Низкий Драйвер класса stream вызывает подпрограмму в PASSIVE_LEVEL. Используйте этот приоритет, если подпрограмма занимает менее 1 миллисекунда.
LowToHigh Используется для разрешения потока, вызываемого с низким приоритетом, вернуться к высокому приоритету, чтобы можно было вызывать другие службы драйверов класса потоков.

[in] PriorityRoutine

Указатель на StrMiniPriorityRoutine для вызова на указанном уровне приоритета.

[in] Context

Указывает параметр, передаваемый в PriorityRoutine.

Возвращаемое значение

Никакой

Требования

Требование Ценность
целевая платформа Настольный
заголовка strmini.h (include Strmini.h)
библиотеки Stream.lib
IRQL (См. раздел "Параметры")