UMDF File Object Interfaces

[Warning: UMDF 2 is the latest version of UMDF and supersedes UMDF 1. All new UMDF drivers should be written using UMDF 2. No new features are being added to UMDF 1 and there is limited support for UMDF 1 on newer versions of Windows 10. Universal Windows drivers must use UMDF 2. For more info, see Getting Started with UMDF.]

In this section

TopicDescription

IFileCallbackCleanup

Note   Warning: UMDF 2 is the latest version of UMDF and supersedes UMDF 1. All new UMDF drivers should be written using UMDF 2. No new features are being added to UMDF 1 and there is limited support for UMDF 1 on newer versions of Windows 10. Universal Windows drivers must use UMDF 2. For more info, see Getting Started with UMDF.
 

The framework can notify a driver when the driver should perform a cleanup operation. The framework notifies the driver in response to an application calling the CloseHandle Microsoft Win32 function. The driver can handle the notification by registering the IFileCallbackCleanup interface.

A driver registers the IFileCallbackCleanup interface when it calls the IWDFDriver::CreateDevice method to create a device object.

IFileCallbackClose

Note   Warning: UMDF 2 is the latest version of UMDF and supersedes UMDF 1. All new UMDF drivers should be written using UMDF 2. No new features are being added to UMDF 1 and there is limited support for UMDF 1 on newer versions of Windows 10. Universal Windows drivers must use UMDF 2. For more info, see Getting Started with UMDF.
 

The framework can notify a driver when the driver should perform a close operation. The driver can handle the notification by registering the IFileCallbackClose interface.

A driver registers the IFileCallbackClose interface when it calls the IWDFDriver::CreateDevice method to create a device object.

IWDFDriverCreatedFile

Note   Warning: UMDF 2 is the latest version of UMDF and supersedes UMDF 1. All new UMDF drivers should be written using UMDF 2. No new features are being added to UMDF 1 and there is limited support for UMDF 1 on newer versions of Windows 10. Universal Windows drivers must use UMDF 2. For more info, see Getting Started with UMDF.
 

The IWDFDriverCreatedFile interface exposes a UMDF driver-created-file object for the driver to use.

IWDFFile

Note   Warning: UMDF 2 is the latest version of UMDF and supersedes UMDF 1. All new UMDF drivers should be written using UMDF 2. No new features are being added to UMDF 1 and there is limited support for UMDF 1 on newer versions of Windows 10. Universal Windows drivers must use UMDF 2. For more info, see Getting Started with UMDF.
 

The IWDFFile interface exposes the file object that represents the HANDLE that is returned by the Microsoft Win32 CreateFile function. All further operations on this handle, such as calls to the Win32 ReadFile function and the DeviceIoControl function, are sent to this file object.

IWDFFile2

Note   Warning: UMDF 2 is the latest version of UMDF and supersedes UMDF 1. All new UMDF drivers should be written using UMDF 2. No new features are being added to UMDF 1 and there is limited support for UMDF 1 on newer versions of Windows 10. Universal Windows drivers must use UMDF 2. For more info, see Getting Started with UMDF.
 

Drivers obtain the IWDFFile2 interface by calling IWDFFile::QueryInterface.

IWDFFile3

Note   Warning: UMDF 2 is the latest version of UMDF and supersedes UMDF 1. All new UMDF drivers should be written using UMDF 2. No new features are being added to UMDF 1 and there is limited support for UMDF 1 on newer versions of Windows 10. Universal Windows drivers must use UMDF 2. For more info, see Getting Started with UMDF.
 

Drivers obtain the IWDFFile3 interface by calling IWDFFile::QueryInterface.

 

 

 

Send comments about this topic to Microsoft

Show: