共用方式為


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_OBJECTHW_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 (請參閱參數一節)