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結構大小。 然後,類別驅動程式會將指標傳遞至HW_STREAM_REQUEST_BLOCK、HW_STREAM_OBJECT、HW_TIME_CONTEXT,以及PORT_CONFIGURATION_INFORMATION傳遞至minidriver的 HwDeviceExtension 成員中的緩衝區。
[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 | (請參閱參數一節) |