IWDFFile3::GetInitiatorProcessId-Methode (wudfddi.h)
[Warnung: UMDF 2 ist die neueste Version von UMDF und ersetzt UMDF 1. Alle neuen UMDF-Treiber sollten mit UMDF 2 geschrieben werden. Es werden keine neuen Features zu UMDF 1 hinzugefügt, und es gibt eingeschränkte Unterstützung für UMDF 1 für neuere Versionen von Windows 10. Universelle Windows-Treiber müssen UMDF 2 verwenden. Weitere Informationen finden Sie unter Erste Schritte mit UMDF-.]
Die GetInitiatorProcessId--Methode ruft die Initiatorprozess-ID ab, die einer IWDFFile--Schnittstelle zugeordnet ist.
Syntax
void GetInitiatorProcessId(
[out] DWORD *pdwProcessId
);
Parameter
[out] pdwProcessId
Gibt die Adresse eines Speicherorts an, der den Initiatorprozessbezeichner empfängt, der der Datei zugeordnet ist, sofern vorhanden. Andernfalls empfängt der Standort 0.
Rückgabewert
Nichts
Bemerkungen
Ab Windows 8 kann eine Systemkomponente eine Erstellung im Auftrag einer App ausgeben. Der Treiber kann GetInitiatorProcessId- aufrufen, um zu bestimmen, für welchen Prozess der Erstellungsvorgang letztendlich vorgesehen ist.
GetInitiatorProcessId null zurück, wenn dem Erstellungsvorgang kein Initiatorprozess zugeordnet ist.
Weitere Informationen zu Frameworkdateiobjekten finden Sie unter Driver-Created Versus Application-Created File Objects.
Beispiele
VOID
STDMETHODCALLTYPE
CMyQueue::OnCreateFile(
__in IWDFIoQueue *pWdfQueue,
__in IWDFIoRequest *pWdfRequest,
__in IWDFFile* pWdfFileObject
)
...
IWDFFile3* pWdfFileObject3 = NULL;
HRESULT hr = S_OK;
DWORD initiatorProcessId;
//
// Obtain IWDFFile3 interface from IWDFFile.
//
hr = pWdfFileObject->QueryInterface(IID_PPV_ARGS(&pWdfFileObject3));
if (!SUCCEEDED(hr))
{
goto Done;
}
pWdfFileObject3->GetInitiatorProcessId(&initiatorProcessId);
...
Anforderungen
| Anforderung | Wert |
|---|---|
| Ende des Supports | In UMDF 2.0 und höher nicht verfügbar. |
| Zielplattform- | Desktop |
| Mindest-UMDF-Version | 1.11 |
| Header- | wudfddi.h (include Wudfddi.h) |
| DLL- | WUDFx.dll |