Hardware Dev Center

IWDFIoTarget::GetTargetFile method

The GetTargetFile method retrieves the framework file object that is associated with the I/O target object.

Syntax


void GetTargetFile(
  [out] IWDFFile **ppFileObject
);

Parameters

ppFileObject [out]

Pointer to a buffer that receives a pointer to the IWDFFile interface for the I/O target's file object.

Return value

None

Remarks

If a framework file object is associated with an I/O target object, the framework includes the file object with I/O requests that the driver sends to the I/O target object.

When a driver formats an I/O request, an I/O target object enables the driver to use either the same file that the request started with or a new file.

The default I/O target has no file object, so a call to GetTargetFile for the default I/O target retrieves NULL.

For more information about I/O targets, see Using I/O Targets in UMDF.

Examples

For a code example of how to use the GetTargetFile method, see IWDFIoTarget::FormatRequestForWrite.

Requirements

Target platform

Desktop

End of support

Unavailable in UMDF 2.0 and later.

Minimum UMDF version

1.5

Header

Wudfddi.h (include Wudfddi.h)

DLL

WUDFx.dll

See also

IWDFIoTarget
IWDFFile

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft