WdfFileObjectGetInitiatorProcessId function (wdffileobject.h)

Article
02/22/2024

[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(
  [in] WDFFILEOBJECT FileObject
);

Parameters

[in] 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

Requirement	Value
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