Jump to main content

##

# 1.1.1.2 DRV_HANDLE Typedef

## C

    typedef uintptr_t DRV_HANDLE;

## Summary

Handle to an opened device driver.

## Description

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.

## Remarks

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.