XXX_Deinit (Device Manager) (Compact 2013)

3/26/2014

This function uninitializes a device.

Syntax

BOOL XXX_Deinit(
  DWORD hDeviceContext 
);

Parameters

  • hDeviceContext
    [in] Handle to the device context. The XXX_Init (Device Manager) function creates and returns this identifier.

Return Value

TRUE indicates success. FALSE indicates failure.

Remarks

When the user stops using a device, such as when it is removed from its socket, Device Manager calls this function. Applications do not call this function. Device Manager calls the XXX_Deinit driver function as a result of a call to the DeactivateDevice function. Your stream interface driver should free any resources it has allocated, and then terminate.

Device Manager uses the XXX prefix. When implementing the stream interface, replace XXX with a prefix appropriate for your specific implementation or use undecorated entry point names in conjunction with DEVFLAGS_NAKEDENTRIES.For more information about other valid Flags values, see ActivateDeviceEx.

If you have threads blocked in your driver, resources associated with the handle or device instance might not be able to be released. To avoid this, implement the XXX_PreClose (Device Manager) and XXX_PreDeinit (Device Manager) entry points.

Requirements

Header

Developer Implemented

Library

Developer Implemented

See Also

Reference

Stream Interface Driver Functions
ActivateDeviceEx
DeactivateDevice
XXX_Init (Device Manager)
XXX_PreDeinit (Device Manager)