WdfFileObjectGetInitiatorProcessId function

[Applies to UMDF only]

The WdfFileObjectGetInitiatorProcessId function retrieves the initiator process ID that is associated with a specified framework file object.

Syntax


ULONG WdfFileObjectGetInitiatorProcessId(
  _In_  WDFFILEOBJECT FileObject
);

Parameters

FileObject [in]

A handle to a framework file object.

Return value

Returns the initiator process identifier associated with the file, if any exists. Otherwise, the function returns zero.

Remarks

This function is the UMDF version 2 equivalent of IWDFDevice3::GetInitiatorProcessId.

Starting in Windows 8, a system component may issue a create on behalf of an application. The driver can call WdfFileObjectGetInitiatorProcessId to determine which process the create operation is ultimately intended for.

WdfFileObjectGetInitiatorProcessId returns zero if no initiator process is associated with the create operation.

Requirements

Minimum support

Windows 8.1

Minimum UMDF version

2.0

Header

Wdffileobject.h (include Wdf.h)

Library

WUDFx02000.lib

DLL

WUDFx02000.dll

IRQL

PASSIVE_LEVEL

See also

IWDFDevice3::GetInitiatorProcessId

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft