Metodo IWDFFile3::GetInitiatorProcessId (wudfddi.h)

Articolo
02/27/2024

[Avviso: UMDF 2 è la versione più recente di UMDF e sostituisce UMDF 1. Tutti i nuovi driver UMDF devono essere scritti usando UMDF 2. Non vengono aggiunte nuove funzionalità a UMDF 1 ed è disponibile un supporto limitato per UMDF 1 nelle versioni più recenti di Windows 10. I driver di Windows universali devono usare UMDF 2. Per altre info, vedi Introduzione con UMDF.]

Il metodo GetInitiatorProcessId recupera l'ID del processo iniziatore associato a un'interfaccia IWDFFile .

Sintassi

void GetInitiatorProcessId(
  [out] DWORD *pdwProcessId
);

Parametri

[out] pdwProcessId

Specifica l'indirizzo di un percorso che riceve l'identificatore del processo iniziatore associato al file, se presente. In caso contrario, la posizione riceve 0.

Valore restituito

nessuno

Osservazioni

A partire da Windows 8, un componente di sistema può emettere una creazione per conto di un'app. Il driver può chiamare GetInitiatorProcessId per determinare il processo per cui l'operazione di creazione è destinata.

GetInitiatorProcessId restituisce zero se all'operazione di creazione non è associato alcun processo iniziatore.

Per altre informazioni sugli oggetti file del framework, vedere Driver-Created Versus Application-Created File Objects.

Esempio

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);
    ...

Requisiti

Requisito	Valore
Fine del supporto	Non disponibile in UMDF 2.0 e versioni successive.
Piattaforma di destinazione	Desktop
Versione UMDF minima	1.11
Intestazione	wudfddi.h (include Wudfddi.h)
DLL	WUDFx.dll

Vedi anche

IWDFFile3

Condividi tramite