Function Discovery Provider Sample
[Function Discovery is available for use in the following versions of Windows: Windows Server 2012, Windows 8, Windows Server 2008 R2, Windows 7, Windows Server 2008, and Windows Vista. It may be altered or unavailable in subsequent versions.]
Included with this SDK is sample code that demonstrates the use of the Function Discovery provider API. The sample demonstrates how to write a fully functional PnP-X provider by implementing a very simple network protocol. The source code for the sample can be found in the SDK installation location at C:\Program Files\Microsoft SDKs\Windows\<version number>\Samples\winbase\DeviceFoundation\FunctionDiscovery\Provider. The Windows Vista SDK is available from the Download Center.
The Function Discovery provider sample has three components. FDProviderSample.dll contains a COM class that implements the IFunctionDiscoveryProvider interface. FDProviderHostSample.exe implements an executable host for the provider. FDProviderSampleDevice.exe implements a simple soft device that is enumerated by the sample provider. More information about this sample is available in the readme file in the FunctionDiscoveryProvider directory.
The Function Discovery provider sample was developed with the goal of serving as the foundation for implementing providers. It is structured in a way that makes it easy to replace the sample network protocol with a real protocol but preserve the bulk of the code.
To this end, the entire network protocol implementation is contained in DiscoveryProtocol.cpp. TFunctionInstanceInfo is a class that encapsulates all the work of representing the data that represents a device on the network and turns that information into a function instance. The bulk of the work in creating a new provider should be focused on the protocol implementation and in modifying TFunctionInstanceInfo.
Places that require attention during implementation are marked with TODO comments.
The Local System account must have permission to execute files in the folder in which the sample DLL files (such as FDProviderSample.dll) were built.
To grant folder permissions to the Local Service Account
- Start Windows Explorer.
- Browse to the folder in which the sample DLLs were built.
- Right-click the folder, click Properties, and then click the Security tab.
- Click Edit.
- Click Add.
- Type "LOCAL SERVICE" into the text box, and then click Check Names.
- Click OK to close the next three dialog boxes.