WdfFileObjectGetInitiatorProcessId function

[Applies to KMDF and UMDF]

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

Syntax

ULONG WdfFileObjectGetInitiatorProcessId(
  WDFFILEOBJECT FileObject
);

Parameters

FileObject

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

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

   
Target Platform Universal
Minimum KMDF version 1.21
Minimum UMDF version 2.0
Header wdffileobject.h (include Wdf.h)
Library Wdf01000.sys (KMDF); WUDFx02000.lib
DLL WUDFx02000.dll
IRQL DISPATCH_LEVEL

See Also

IWDFDevice3::GetInitiatorProcessId

WdfRequestGetRequestorProcessId