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

另請參閱

STOR_THREAD_PRIORITY

STOR_THREAD_START_ROUTINE

StorPortSetPriorityThread

StorPortTerminateSystemThread