Metodo IWDFFile3::GetInitiatorProcessId (wudfddi.h)

[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 informazioni, vedi Introduzione a 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 quale processo 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.

Esempi

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

Fabbisogno

Requisito	Valore
Fine del supporto	Non disponibile in UMDF 2.0 e versioni successive.
piattaforma di destinazione	Desktop
versione minima di UMDF	1.11
intestazione	wudfddi.h (include Wudfddi.h)
dll	WUDFx.dll

Vedere anche

IWDFFile3