共用方式為


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

另請參閱

STOR_THREAD_PRIORITY

STOR_THREAD_START_ROUTINE

StorPortSetPriorityThread

StorPortTerminateSystemThread