StreamClassCallAtNewPriority-Funktion (strmini.h)

Die StreamClassCallAtNewPriority Routine plant eine Routine, die an einer anderen Priorität aufgerufen werden soll.

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 den Datenstrom angibt, der Routine zugeordnet ist, oder NULL-, wenn die Routine dem Gerät als Ganzes zugeordnet ist. Pro Stream kann nur eine Routine und nur eine Routine für das Gerät vorhanden sein. 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 StreamClassRegisterMinidriverregistriert. Der Klassentreiber übergibt dann Zeiger an den Puffer in der HwDeviceExtension Member des HW_STREAM_REQUEST_BLOCK, HW_STREAM_OBJECT, HW_TIME_CONTEXTund PORT_CONFIGURATION_INFORMATION Strukturen, die an den Minidriver übergeben werden.

[in] Priority

Gibt einen der werte an, die in der folgenden Tabelle aufgeführt sind.

Priorität	Verwendung
Hoch	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 Interrupt-Dienstroutine des Minidrivers synchronisiert werden muss.
Versand	Der Streamklassentreiber ruft die Routine bei DISPATCH_LEVEL auf. Verwenden Sie diese Priorität, wenn die Routine weniger als 1 Millisekunden zum Abschließen benötigt.
Niedrig	Der Streamklassentreiber ruft die Routine bei PASSIVE_LEVEL auf. Verwenden Sie diese Priorität, wenn die Routine weniger als 1 Millisekunden zum Abschließen benötigt.
LowToHigh	Wird verwendet, um zuzulassen, dass ein Thread, der mit niedriger Priorität aufgerufen wird, zu hoher Priorität zurückkehrt, sodass andere Streamklassentreiberdienste aufgerufen werden können.

[in] PriorityRoutine

Zeiger auf einen von minidriver bereitgestellten StrMiniPriorityRoutine, die auf der angegebenen Prioritätsebene aufgerufen werden sollen.

[in] Context

Gibt den Parameter an, der an die PriorityRoutineübergeben werden soll.

Rückgabewert

Nichts

Anforderungen

Anforderung	Wert
Zielplattform-	Desktop
Header-	strmini.h (einschließlich Strmini.h)
Library	Stream.lib
IRQL-	(Siehe Parameterabschnitt)