1.1.1.2 DRV_HANDLE Typedef

typedef uintptr_t DRV_HANDLE;

Handle to an opened device driver.

This handle identifies the open instance of a device driver. It must be passed to all other driver routines (except the initialization, deinitialization, or power routines) to identify the caller.

Every application or module that wants to use a driver must first call the driver's open routine. This is the only routine that is absolutely required for every driver.

If a driver is unable to allow an additional module to use it, it must then return the special value DRV_HANDLE_INVALID. Callers should check the handle returned for this value to ensure this value was not returned before attempting to call any other driver routines using the handle.