StorPortWaitForSingleObject 函式 (storport.h)

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

語法

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

參數

HwDeviceExtension

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

Object

初始化發送器物件的指標 (事件、mutex、號誌、線程或定時器) 。

Alertable

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

Timeout

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

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

如果 Timeout = 0，則例程會傳回而不等待。 如果迷你埠提供 NULL 指標，則例程會無限期等候，直到發送器物件設定為已發出訊號的狀態為止。 如需詳細資訊，請參閱接下來的＜備註＞一節。

傳回值

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

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

備註

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

StorportWaitForSingleObject 的呼叫端必須在 IRQL <= DISPATCH_LEVEL執行。 不過，如果 Timeout = NULL 或 Timeout ！= 0，則呼叫端必須在 IRQL <= APC_LEVEL且在非位線程內容中執行。 (如果 Timeout ！= NULL 和 Timeout = 0，則呼叫端必須在 IRQL <= DISPATCH_LEVEL.)

規格需求

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

另請參閱

KeWaitForSingleObject

StorportInitializeEvent

StorportSetEvent