WdfFileObjectGetInitiatorProcessId function (wdffileobject.h)
[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 |