Metode IWDFFile3::GetInitiatorProcessId (wudfddi.h)

Artikel
03/01/2024

[Peringatan: UMDF 2 adalah versi terbaru UMDF dan pengganti UMDF 1. Semua driver UMDF baru harus ditulis menggunakan UMDF 2. Tidak ada fitur baru yang ditambahkan ke UMDF 1 dan ada dukungan terbatas untuk UMDF 1 pada versi Windows 10 yang lebih baru. Driver Universal Windows harus menggunakan UMDF 2. Untuk informasi selengkapnya, lihat Mulai menggunakan UMDF.]

Metode GetInitiatorProcessId mengambil ID proses inisiator yang terkait dengan antarmuka IWDFFile .

Sintaks

void GetInitiatorProcessId(
  [out] DWORD *pdwProcessId
);

Parameter

[out] pdwProcessId

Menentukan alamat lokasi yang menerima pengidentifikasi proses inisiator yang terkait dengan file, jika ada. Jika tidak, lokasi akan menerima 0.

Nilai kembali

Tidak ada

Keterangan

Mulai dari Windows 8, komponen sistem dapat mengeluarkan buat atas nama aplikasi. Driver dapat memanggil GetInitiatorProcessId untuk menentukan proses mana yang pada akhirnya dimaksudkan untuk operasi pembuatan.

GetInitiatorProcessId mengembalikan nol jika tidak ada proses inisiator yang terkait dengan operasi pembuatan.

Untuk informasi selengkapnya tentang objek file kerangka kerja, lihat Objek File yang Dibuat Driver Versus Application-Created.

Contoh

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

Persyaratan

Persyaratan	Nilai
Akhir dukungan	Tidak tersedia di UMDF 2.0 dan yang lebih baru.
Target Platform	Desktop
Versi UMDF minimum	1.11
Header	wudfddi.h (termasuk Wudfddi.h)
DLL	WUDFx.dll

Lihat juga

IWDFFile3

Bagikan melalui