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 會傳回下列其中一個值:
傳回碼 | Description |
---|---|
STOR_STATUS_SUCCESS | 已成功建立系統線程。 |
STOR_STATUS_INVALID_PARAMETER | 提供的一或多個參數無效。 |
STOR_STATUS_UNSUCCESSFUL | 基於其他內部系統原因而傳回。 |
備註
建立裝置專用線程的迷你埠驅動程式會在初始化或 I/O 要求開始傳入驅動程式的 Dispatch 例程時呼叫 StorPortCreateSystemThread。 例如,驅動程式可能會在收到異步裝置控制要求時建立這類線程。
線程會繼續執行,直到系統關閉或線程藉由呼叫 StorPortTerminateSystemThread 自行終止為止。
您可以呼叫 StorPortSetPriorityThread 來變更線程優先順序。 迷你埠應該指定線程優先順序值,以避免運行時間優先順序反轉。 如需詳細資訊,請參閱 裝置專用線程 。
針對指定的配接器,迷你埠可以建立的最大系統線程是系統中的最大邏輯處理器計數。
規格需求
需求 | 值 |
---|---|
最低支援的伺服器 | Windows Server 2022 |
標頭 | storport.h |