Méthode IWDFFile3 ::GetInitiatorProcessId (wudfddi.h)

Article
02/27/2024

[Avertissement : UMDF 2 est la dernière version d’UMDF et remplace UMDF 1. Tous les nouveaux pilotes UMDF doivent être écrits à l’aide d’UMDF 2. Aucune nouvelle fonctionnalité n’est ajoutée à UMDF 1 et la prise en charge d’UMDF 1 est limitée sur les versions plus récentes de Windows 10. Les pilotes Windows universels doivent utiliser UMDF 2. Pour plus d’informations, consultez Prise en main avec UMDF.]

La méthode GetInitiatorProcessId récupère l’ID de processus initiateur associé à une interface IWDFFile .

Syntaxe

void GetInitiatorProcessId(
  [out] DWORD *pdwProcessId
);

Paramètres

[out] pdwProcessId

Spécifie l’adresse d’un emplacement qui reçoit l’identificateur de processus initiateur associé au fichier, le cas échéant. Sinon, l’emplacement reçoit 0.

Valeur de retour

None

Remarques

À compter de Windows 8, un composant système peut émettre une création pour le compte d’une application. Le pilote peut appeler GetInitiatorProcessId pour déterminer le processus auquel l’opération de création est destinée.

GetInitiatorProcessId retourne zéro si aucun processus initiateur n’est associé à l’opération de création.

Pour plus d’informations sur les objets de fichier d’infrastructure, consultez Objets de fichier créés par un pilote et Application-Created.

Exemples

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

Configuration requise

Condition requise	Valeur
Fin de la prise en charge	Non disponible dans UMDF 2.0 et versions ultérieures.
Plateforme cible	Desktop (Expérience utilisateur)
Version UMDF minimale	1.11
En-tête	wudfddi.h (inclure Wudfddi.h)
DLL	WUDFx.dll

Voir aussi

IWDFFile3

Partager via