StreamClassCallAtNewPriority-Funktion (strmini.h)

  • Artikel

Die StreamClassCallAtNewPriority-Routine plant eine Routine, die mit einer anderen Priorität aufgerufen wird.

Syntax

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

Parameter

[in, optional] StreamObject

Zeiger auf eine HW_STREAM_OBJECT Struktur, die angibt, dass der Stream der Routine zugeordnet ist, oder NULL , wenn die Routine dem Gerät als Ganzes zugeordnet ist. Es kann nur eine Routine pro Stream und nur eine Routine für das Gerät geben. Dieser Parameter ist optional.

[in] HwDeviceExtension

Zeiger auf die Geräteerweiterung des Minidrivers. Der Minidriver gibt die Größe dieses Puffers in der HW_INITIALIZATION_DATA-Struktur an, die er übergibt, wenn er sich über StreamClassRegisterMinidriver registriert. Der Klassentreiber übergibt dann Zeiger an den Puffer im HwDeviceExtension-Member der strukturen HW_STREAM_REQUEST_BLOCK, HW_STREAM_OBJECT, HW_TIME_CONTEXT und PORT_CONFIGURATION_INFORMATION , die er an den Minitreiber übergibt.

[in] Priority

Gibt einen der in der folgenden Tabelle aufgeführten Werte an.

Priority Verbrauch
High Der Streamklassentreiber ruft die Routine mit der gleichen Priorität wie die StrMiniXxx-Rückrufe des Minidrivers auf. Verwenden Sie diese Einstellung nur, wenn die Routine mit der Interruptdienstroutine des Minidrivers synchronisiert werden muss.
Dispatch Der Streamklassentreiber ruft die Routine bei DISPATCH_LEVEL auf. Verwenden Sie diese Priorität, wenn die Routine weniger als 1 Millisekunde benötigt.
Niedrig Der Streamklassentreiber ruft die Routine bei PASSIVE_LEVEL auf. Verwenden Sie diese Priorität, wenn die Routine weniger als 1 Millisekunde benötigt.
LowToHigh Wird verwendet, damit ein Thread mit niedriger Priorität zur hohen Priorität zurückkehren kann, sodass andere Streamklassentreiberdienste aufgerufen werden können.

[in] PriorityRoutine

Zeiger auf eine vom Minidriver bereitgestellte StrMiniPriorityRoutine , die auf der angegebenen Prioritätsebene aufgerufen werden soll.

[in] Context

Gibt den Parameter an, der an priorityRoutine übergeben werden soll.

Rückgabewert

Keine

Anforderungen

Anforderung Wert
Zielplattform Desktop
Kopfzeile strmini.h (include Strmini.h)
Bibliothek Stream.lib
IRQL (Siehe Abschnitt Parameter)