閱讀英文

共用方式為

StorPortWaitForSingleObject 函式 （storport.h）

  • 發行項

迷你埠可以呼叫 StorPortWaitForSingleObject 函式，將目前的線程置於等候狀態，直到指定的發送器物件設定為訊號狀態或選擇性逾時為止。

語法

C++ 
ULONG StorPortWaitForSingleObject(
  PVOID          HwDeviceExtension,
  PVOID          Object,
  BOOLEAN        Alertable,
  PLARGE_INTEGER Timeout
);

參數

HwDeviceExtension

記憶體迷你埠裝置延伸模組的指標。

Object

初始化發送器物件的指標（event、mutex、semaphore、thread 或 timer）。

Alertable

如果等候可警示，則布爾值會設定 TRUE，否則為 FALSE。

Timeout

指定絕對時間或相對時間的逾時值指標，以 100 奈秒為單位，等候完成。

正值會指定絕對時間，相對於 1601 年 1 月 1 日。 負值會指定相對於目前時間的間隔。 絕對到期時間會追蹤系統時間中的任何變更;相對到期時間不會受到系統時間變更的影響。

如果 逾時 = 0，則例程會傳回而不等候。 如果迷你埠提供 NULL 指標，則例程會無限期等候，直到發送器物件設定為訊號狀態為止。 如需詳細資訊，請參閱下列一節。

傳回值

StorPortSetEvent 會傳回狀態代碼，例如下列其中一項：

傳回碼 描述
STOR_STATUS_INVALID_PARAMETER 一或多個參數無效。
STOR_STATUS_SUCCESS 已成功記錄 ETW 事件。
STOR_STATUS_UNSUCCESSFUL 作業失敗。

言論

如需詳細資訊，請參閱 KeWaitForSingleObject。

StorportWaitForSingleObject 的呼叫端必須在 IRQL <= DISPATCH_LEVEL 執行。 不過，如果 Timeout = NULL 或 Timeout ！= 0，則呼叫端必須在 IRQL <= APC_LEVEL 和非bitrary 線程內容中執行。 （如果 逾時 ！= NULL 和 Timeout = 0，呼叫端必須在 IRQL <= DISPATCH_LEVEL 執行。

要求

要求 價值
最低支援的用戶端 Windows 10 版本 2004
標頭 storport.h

另請參閱

KeWaitForSingleObject

StorportInitializeEvent

StorportSetEvent