NdisAllocateTimerObject 函式 (ndis.h)

  • 發行項

NdisAllocateTimerObject 函式會配置並初始化定時器物件，以便與後續的 NdisXxx 定時器函式搭配使用。

語法

NDIS_STATUS NdisAllocateTimerObject(
  [in]  NDIS_HANDLE                 NdisHandle,
  [in]  PNDIS_TIMER_CHARACTERISTICS TimerCharacteristics,
  [out] PNDIS_HANDLE                pTimerObject
);

參數

[in] NdisHandle

在呼叫端初始化期間取得的 NDIS 句柄。 如需取得 NDIS 句柄的詳細資訊，請參閱 取得集區句柄。

[in] TimerCharacteristics

呼叫端提供的指標 NDIS_TIMER_CHARACTERISTICS 結構，指定配置定時器物件的特性。

[out] pTimerObject

NDIS 提供的 NDIS 定時器物件句柄指標，可在 後續呼叫 NdisXxx 定時器函式時識別定時器物件。

傳回值

NdisAllocateTimerObject 會傳回下列其中一個狀態值：

傳回碼 Description
NDIS_STATUS_SUCCESS
 已成功配置定時器物件。
NDIS_STATUS_RESOURCES
 配置失敗，因為資源不足。
NDIS_STATUS_BAD_CHARACTERISTICS
 配置失敗，因為NDIS_TIMER_CHARACTERISTICS結構中的資訊無效。
NDIS_STATUS_FAILURE
 上述狀態值都不適用。

備註

若要使用定時器服務，NDIS 驅動程式會先呼叫 NdisAllocateTimerObject 函式來初始化定時器物件。 一般而言，在驅動程式初始化期間會呼叫 NdisAllocateTimerObject 。

若要啟動定時器，請呼叫 NdisSetTimerObject 函式。 呼叫 NdisSetTimerObject 會在系統定時器佇列中插入定時器物件。 在任何指定時間，只能將特定定時器物件的一個實例排入佇列。

若要取消定時器，請呼叫 NdisCancelTimerObject 函式。 如果定時器物件目前已排入佇列，則 NdisCancelTimerObject 會取消佇列。

若要釋放定時器物件，您必須呼叫 NdisFreeTimerObject 函式。

規格需求

需求 值
最低支援的用戶端 NDIS 6.0 和更新版本支援。
目標平台 Universal
標頭 ndis.h (包含 Ndis.h)
程式庫 Ndis.lib
IRQL <= DISPATCH_LEVEL
DDI 合規性規則 Irql_Timer_Function ()

另請參閱

NDIS_TIMER_CHARACTERISTICS

NdisCancelTimerObject

NdisFreeTimerObject

NdisSetTimerObject