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 會傳回下列其中一個狀態值：
| 傳回碼 | 描述 |
|---|---|
|
已成功配置定時器物件。 |
|
配置失敗，因為資源不足。 |
|
配置失敗，因為NDIS_TIMER_CHARACTERISTICS結構中的資訊無效。 |
|
上述狀態值都不適用。 |
言論
若要使用定時器服務，NDIS 驅動程式會先呼叫 NdisAllocateTimerObject 函式來初始化定時器物件。 一般而言，NdisAllocateTimerObject 在驅動程式初始化期間呼叫。
若要啟動定時器，請呼叫 NdisSetTimerObject 函式。 呼叫 NdisSetTimerObject 在系統定時器佇列中插入定時器物件。 在任何指定的時刻，只能將特定定時器物件的一個實例排入佇列。
若要取消定時器，請呼叫 NdisCancelTimerObject 函式。 NdisCancelTimerObject 在目前已排入佇列時清除定時器物件。
若要釋放定時器物件，您必須呼叫 NdisFreeTimerObject 函式。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | NDIS 6.0 和更新版本支援。 |
| 目標平臺 | 普遍 |
| 標頭 | ndis.h （包括 Ndis.h） |
| 連結庫 | Ndis.lib |
| IRQL | <= DISPATCH_LEVEL |
| DDI 合規性規則 | Irql_Timer_Function（ndis） |