udi_init_context_t(3udi)

---

Initial context for new regions

SYNOPSIS

#include <udi.h>

typedef struct {

	udi_index_t region_idx;

	udi_limits_t limits;

} udi_init_context_t;
 

MEMBERS region_idx is a region index value that indicates the type of this region. For a driver's primary region, it will be zero. For secondary regions, it will be the value from the udi_secondary_init_t that was used to create this region.

limits is a structure that describes system resource limits. See udi_limits_t.

DESCRIPTION The udi_init_context_t structure is stored at the front of the region data area of each newly created region, providing initial data that a driver will need to begin executing in the region. A pointer to this structure (and therefore the region data area as a whole) is made available to the driver as the initial channel context for its first channel.

For primary regions, the first channel will be the management channel for the driver instance (see Chapter 24, "Management Metalanguage"). For secondary regions, the first channel will be the initial channel between this secondary region and the primary region, using either the Generic I/O Metalanguage (see Chapter 25) or a custom metalanguage.

REFERENCES udi_init_info, udi_limits_t