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 會指定它透過 StreamClassRegisterMinidriver 註冊本身時,它會在 HW_INITIALIZATION_DATA 結構中傳遞的這個緩衝區大小。 然後,類別驅動程式會將指標傳遞至 HwDeviceExtension 中HW_STREAM_REQUEST_BLOCK、HW_STREAM_OBJECT、HW_TIME_CONTEXT,以及 PORT_CONFIGURATION_INFORMATION 傳遞至迷你驅動程序的結構。
[in] Priority
指定下表所列的其中一個值。
優先權 | 用法 |
---|---|
高 | 數據流類別驅動程式會以與minidriver StrMiniXxx 回呼相同的優先順序呼叫例程。 除非例程必須與迷你驅動程式的中斷服務例程同步,否則請勿使用此設定。 |
遣 | 數據流類別驅動程式會在 DISPATCH_LEVEL呼叫例程。 如果例程需要少於 1 毫秒才能完成,請使用此優先順序。 |
低 | 數據流類別驅動程式會在 PASSIVE_LEVEL呼叫例程。 如果例程需要少於 1 毫秒才能完成,請使用此優先順序。 |
LowToHigh | 用來允許低優先順序呼叫的線程傳回高優先順序,以便呼叫其他數據流類別驅動程序服務。 |
[in] PriorityRoutine
要以指定優先順序層級呼叫的minidriver StrMiniPriorityRoutine 指標。
[in] Context
指定要傳遞至 PriorityRoutine的參數。
傳回值
沒有
要求
要求 | 價值 |
---|---|
目標平臺 | 桌面 |
標頭 | strmini.h (包括 Strmini.h) |
連結庫 | Stream.lib |
IRQL | (請參閱參數一節) |