NdisWaitEvent

BOOLEAN
NdisWaitEvent(
IN PNDIS_EVENT Event,
IN UINT MsToWait
);

NdisWaitEvent puts the caller into a wait state until the given event is set to the Signaled state or the wait times out.

Parameters

Event

Points to an initialized event object for which the caller provides the storage.

MsToWait

Specifies the number of milliseconds the caller will wait if the event is not set to the Signaled state within that interval.

Return Value

NdisWaitEvent returns TRUE if the event is in the Signaled state when the wait is satisfied.

Comments

NdisWaitEvent returns control to its caller when the given event is Signaled or the given MsToWait interval expires, whichever is sooner. If the event is currently in the Signaled state when this call occurs, NdisWaitEvent returns control immediately.

NIC drivers can call NdisWaitEvent from their MiniportInitialize functions. Protocol drivers can call this function when they are running at IRQL < DISPATCH_LEVEL and in a nonarbitrary thread context, such as from their DriverEntry or ProtocolBindAdapter routines.

Callers of NdisWaitEvent must be running at IRQL PASSIVE_LEVEL.

See Also

DriverEntry of NDIS Protocol Drivers, MiniportHalt, MiniportInitialize, NdisInitializeEvent, NdisResetEvent, NdisSetEvent, ProtocolBindAdapter, ProtocolUnbindAdapter