XXX_Deinit (Device Manager)

Other versions of this page are also available for the following:

Windows Mobile Not SupportedWindows Embedded CE Supported

8/28/2008

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 a PC Card 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
Windows Embedded CE Windows CE 1.0 and later

See Also

Reference

ActivateDeviceEx
DeactivateDevice
XXX_Init (Device Manager)
XXX_PreDeinit (Device Manager)

Concepts

Device File Names