Important: |
---|
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
This function initializes a timer object associated with a driver's MiniportTimerfunction.
VOID NdisMInitializeTimer( IN OUT PNDIS_MINIPORT_TIMER Timer , IN NDIS_HANDLE MiniportAdapterHandle , IN PNDIS_TIMER_FUNCTION TimerFunction , IN PVOID FunctionContext );
Parameters
Remarks
MiniportInitializemust call this function to set up the driver's MiniportTimerfunction(s), if any. MiniportInitializemust call this function before the driver passes the MiniportTimer pointer to any other NDIS timer function.
Drivers of network adapters that do not generate interrupts initialize at least one timer object for a polling MiniportTimerfunction that monitors the network adapter state for incoming receives and for send completions.
Calls to the NDIS timer functions insert the timer object in the system timer queue. Calls to the NdisMCancelTimerfunction dequeue the timer object if it is currently queued. Only one instantiation of a particular timer object can be queued at any given moment.
MiniportInitializecan call this function more than once to initialize more than one timer object, each associated with a distinct MiniportTimerfunction. For example, a network adapter driver might have one MiniportTimerfunction that polls the network adapter state periodically and another that the miniport uses only to time-out a particular operation on its network adapter. Each such MiniportTimerfunction has different functionality should be associated with a different timer object by calling this function from MiniportInitialize.
Requirements
Runs on | Versions | Defined in | Include | Link to |
---|---|---|---|---|
Windows CE OS | 2.0 and later | Ndis.h | Ndislib.lib |
Note This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.
See Also
MiniportInitialize, NdisMCancelTimer, NdisMSetPeriodicTimer, NdisMSetTimer