NdisInitializeEvent (NDIS 5.1) function

Article
06/19/2017

Note NDIS 5. x has been deprecated and is superseded by NDIS 6. x. For new NDIS driver development, see Network Drivers Starting with Windows Vista. For information about porting NDIS 5. x drivers to NDIS 6. x, see Porting NDIS 5.x Drivers to NDIS 6.0.

NdisInitializeEvent sets up an event object during driver initialization to be used subsequently as a synchronization mechanism.

Syntax

VOID NdisInitializeEvent(
  _Out_ PNDIS_EVENT Event
);

Parameters

Event [out]
Pointer to caller-supplied storage for the event object, which is opaque to drivers.

Return value

None

Remarks

The NdisInitializeEvent function creates an event object that has an event type of NotificationEvent and an initital state of not-signaled. For more information about notification events, see Defining and Using an Event Object.

The Event pointer passed to NdisInitializeEvent is a required parameter to all other Ndis..Event functions.

While driver functions that must run at IRQL <= DISPATCH_LEVEL can call NdisSetEvent and NdisResetEvent, calling NdisWaitEvent from any IRQL > PASSIVE_LEVEL is a fatal error.

Requirements

Target platform	Universal
Version	See NdisInitializeEvent.
Header	Ndis.h (include Ndis.h)
Library	Ndis.lib
IRQL	Any level