sdi_dev_read_opr(D3sdi)

sdi_dev_read_opr -- read the SDI description structure

Synopsis

   #include <sys/types.h>
   #include <sys/sdi.h>
   #include <sys/ddi.h>
   
   boolean_t sdi_dev_read_opr( rm_key_t key,
             sdi_device_t *next);

Description

sdi_dev_read_opr( ) obtains the SDI device description structure from the resource manager database and reads it into the specified buffer. This structure completely describes the SDI device.

Arguments

key: ``Resource manager database''Resource manager key, typically made known to the driver by a call to the driver's config(D2sdi) entry point routine.
next: Pointer to a previously allocated sdi_device(D4sdi) structure.

Return values

sdi_dev_read_opr( ) returns B_TRUE on success, or B_FALSE if key is invalid.

Usage

sdi_dev_read_opr( ) is called any time a driver wants to obtain a complete description of an SDI device from a resource manager key. For efficiency, it should be called only from the config(D2sdi) entry point routine of a driver and its value cached.

Context and synchronization

Blockable context.

Driver-defined basic locks, read/write locks, and sleep locks cannot be held across calls to this function.

Hardware applicability

All

Version applicability

sdi: 4 layered drivers

References

sdi_device(D4sdi), sdi_dev_write_opr(D3sdi)