Location Framework Plugin Functions

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

• Windows Embedded CE 6.0 R3

8/28/2008

For the Location Framework to function it must make requests to the Provider and Resolver services inside the plugin DLL. The plugin writer must provide these interfaces.

For communicating back to the Location Framework the pluigin dll should use one of the callback functions, see Location Framework Plugin Callback Functions.

In This Section

The following table shows the functions that the Provider and Resolver plugins must implement for the Location Framework to call. Each interface has a description of its intended purpose.

Programming element	Description
ProviderGetLocation	This function tells the Provider to begin to determine the location.
ProviderInitialize	This function is called immediately after the Provider DLL is loaded. All Providers are loaded when the Location Framework loads or restarts.
ProviderIoctlCall	This function will pass control codes directly to the Provider's handle.
ProviderIoctlClose	This function closes direct access to the Provider.
ProviderIoctlOpen	This function will return a handle to a Provider for direct access.
ProviderStop	This function tells the Provider it is no longer required. It must shutdown and return from ProviderGetLocation as soon as possible.
ProviderUnInitialize	This function indicates that the Provider is about to be unloaded and must block until all this Provider's created threads are stopped.
ResolverGetLocation	This function is called when the Location Framework needs this Resolver to resolve a specific report.
ResolverInitialize	This function is called immediately after the Resolver DLL is loaded.
ResolverIoctlCall	This function will pass control codes directly to the Resolver's handle.
ResolverIoctlClose	This function closes direct access to the Resolver.
ResolverIoctlOpen	This function will return a handle to a Resolver for direct access.
ResolverStop	This function tells the Resolver it is no longer required. It must shutdown and return from ResolverGetLocation if is is running.
ResolverUnInitialize	This function tells the Resolver that it is about to be unloaded. This function must block until all worker threads the Resolver has created are stopped.

See Also

Reference

Location Framework Plugin Reference
Location Framework Plugin Callback Functions
Location Framework Plugin Structures