StorPortCreateSystemThread 函式 (storport.h)
StorPortCreateSystemThread 會建立系統線程,並提供線程內容的指標。
語法
ULONG StorPortCreateSystemThread(
[in] PVOID HwDeviceExtension,
[in] PSTOR_THREAD_START_ROUTINE StartRoutine,
[in/optional] PVOID StartContext,
[in/optional] PSTOR_THREAD_PRIORITY Priority,
[out/optional] PVOID *ThreadContext
);
參數
[in] HwDeviceExtension
迷你埠硬體裝置延伸模組的指標。
[in] StartRoutine
新建立之系統線程進入點的指標。 這個參數是接收單一自變數之 STOR_THREAD_START_ROUTINE 回呼的函式指標,這是 startContext 參數值。
[in/optional] StartContext
當線程開始執行時傳遞至線程的單一自變數指標。
[in/optional] Priority
指定線程優先順序之 STOR_THREAD_PRIORITY 列舉值的指標。
[out/optional] ThreadContext
將接收線程內容的變數指標。
傳回值
StorPortCreateSystemThread 會傳回下列其中一個值:
傳回碼 | 描述 |
---|---|
STOR_STATUS_SUCCESS | 已成功建立系統線程。 |
STOR_STATUS_INVALID_PARAMETER | 提供的一或多個參數無效。 |
STOR_STATUS_UNSUCCESSFUL | 基於其他內部系統原因傳回。 |
言論
建立裝置專用線程的迷你埠驅動程式會呼叫 storPortCreateSystemThread ,當它們初始化或 I/O 要求開始傳入驅動程式 分派 例程時。 例如,驅動程式可能會在收到異步裝置控制要求時建立這類線程。
線程會繼續執行,直到系統關閉或線程呼叫 storPortTerminateSystemThread終止本身為止。
呼叫 StorPortSetPriorityThread ,即可變更線程優先順序。 迷你埠應該指定線程優先順序值,以避免運行時間優先順序反轉。 如需詳細資訊,請參閱 裝置專用線程。
針對指定的配接器,迷你埠可以建立的系統線程上限是系統中邏輯處理器計數上限。
要求
要求 | 價值 |
---|---|
支援的最低伺服器 | Windows Server 2022 |
標頭 | storport.h |