Метод IWDFFile3::GetInitiatorProcessId (wudfddi.h)

Статья
02/07/2025

[ предупреждение: UMDF 2 является последней версией UMDF и заменяет UMDF 1. Все новые драйверы UMDF должны быть написаны с помощью UMDF 2. Новые функции не добавляются в UMDF 1, а поддержка UMDF 1 в более новых версиях Windows 10 ограничена. Универсальные драйверы Windows должны использовать UMDF 2. Дополнительные сведения см. в разделе Начало работы с UMDF.]

Метод getInitiatorProcessId получает идентификатор процесса инициатора, связанный с интерфейсом IWDFFile.

Синтаксис

void GetInitiatorProcessId(
  [out] DWORD *pdwProcessId
);

Параметры

[out] pdwProcessId

Указывает адрес расположения, получающего идентификатор процесса инициатора, связанного с файлом, если он существует. В противном случае расположение получает значение 0.

Возвращаемое значение

Никакой

Замечания

Начиная с Windows 8 системный компонент может выдавать создание от имени приложения. Драйвер может вызывать GetInitiatorProcessId, чтобы определить, для какого процесса создается операция создания.

GetInitiatorProcessId возвращает ноль, если процесс инициатора не связан с операцией создания.

Дополнительные сведения об объектах файлов платформы см. в Driver-Created и Application-Createdфайлов.

Примеры

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

Требования

Требование	Ценность
завершение поддержки	Недоступно в UMDF 2.0 и более поздних версиях.
целевая платформа	Настольный
минимальная версия UMDF	1.11
заголовка	wudfddi.h (include Wudfddi.h)
DLL	WUDFx.dll

См. также

IWDFFile3

Поделиться через