sdi_event_alloc(D3sdi)

sdi_event_alloc -- allocate a driver event structure

Synopsis

   #include <sys/sdi.h>

   struct sdi_event * sdi_event_alloc(int flag);

Description

sdi_event_alloc allocates a driver event structure.

Arguments

flag: indicates whether the allocation can sleep or not, and is set to either KM_SLEEP or KM_NOSLEEP

Return values

Pointer to an sdi_event structure.

Usage

Only sdi_event_alloc should be used to allocate an sdi_event. All fields are set to zero in the returned sdi_event structure.

SDI can add fields o the end of the sdi_event structure for use by SDI. This implies that SDI drivers may not use sdi_event structures allocated themselves. Target drivers must allocate an sdi_event structure with the sdi_event_alloc(D3sdi) function.

Context and synchronization

If flag is set to KM_NOSLEEP, non-blockable, initialization, or interrupt context.

If flag is set to KM_SLEEP, user context.

Applicable hardware

x86/Pentium compatible architectures

Version applicability

sdi: 2, 3, 4 target drivers.

References

sdi_addevent(D3sdi), sdi_event(D4sdi), sdi_event_free(D3sdi), sdi_notifyevent(D3sdi), sdi_rmevent(D3sdi)

``SDI event handling'' in HDK Technical Reference