WdfPostDeviceInstall function (wdfinstaller.h)
[Applies to KMDF only]
The co-installer's WdfPostDeviceInstall function performs any operations that the co-installer might require after a non-Plug and Play (PnP) driver's installer has created the driver's kernel-mode service.
Syntax
ULONG WdfPostDeviceInstall(
[in] LPCWSTR InfPath,
[in, optional] LPCWSTR InfSectionName
);
Parameters
[in] InfPath
A pointer to a null-terminated wide-character string that contains the directory path to the driver's INF file. The driver's installer can obtain this string by calling GetCurrentDirectory, which is described in the Microsoft Windows SDK.
[in, optional] InfSectionName
A pointer to a null-terminated wide-character string that contains the Wdf-install-section name in the driver's INF file. For more information about this name, see Using the KMDF Co-installer. If this pointer is NULL, the co-installer uses WdfSection for the name.
Return value
WdfPostDeviceInstall returns ERROR_SUCCESS if the operation succeeds. Otherwise, the function returns one of the additional ERROR_XXX values that are defined in Winerror.h.
Remarks
The installer for the framework-based drivers of a non-PnP device must call WdfPostDeviceInstall after the installer calls CreateService.
To obtain the address of the co-installer's WdfPostDeviceInstall function, the installer must call GetProcAddress after the installer has called LoadLibrary to load the co-installer.
For more information about the WdfPostDeviceInstall function and installers for framework-based drivers of non-PnP devices, see Installing a Non-PnP Driver. For more information about CreateService, GetProcAddress, and LoadLibrary, see the Microsoft Windows SDK documentation.
Examples
For a code example that uses the WdfPostDeviceInstall function, see the installer for the NONPNP sample.
Requirements
Requirement | Value |
---|---|
Target Platform | Universal |
Minimum KMDF version | 1.0 |
Header | wdfinstaller.h (include Wdfinstaller.h) |
Library | N/A (Exported by the KMDF co-installer library. For information about the co-installer library's filename, see Using the KMDF Co-installer.) |