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_TIMER_CHARACTERISTICS結構中的資訊無效。 |
|
上述狀態值都不適用。 |
備註
若要使用定時器服務，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 () |