Bagikan melalui

Metode IWDFIoRequest2::GetCreateParametersEx (wudfddi.h)

  • Artikel

[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 GetCreateParametersEx mengambil parameter pembuatan file yang terkait dengan file yang sedang dibuat atau dibuka.

Sintaks

void GetCreateParametersEx(
  [out, optional] ULONG       *pOptions,
  [out, optional] USHORT      *pFileAttributes,
  [out, optional] USHORT      *pShareAccess,
  [out, optional] ACCESS_MASK *pDesiredAccess
);

Parameter

[out, optional] pOptions

Penunjuk ke variabel yang dialokasikan penelepon yang menerima bendera bit yang menunjukkan opsi pembuatan file. Bendera bit bernama FILE_XXXX ini didefinisikan dalam Wdm.h.

24 bit rendah dari variabel menunjukkan opsi untuk diterapkan saat membuat atau membuka file. Untuk informasi selengkapnya tentang bit ini, lihat deskripsi parameter CreateOptions dari fungsi ZwCreateFile mode kernel.

Delapan bit tinggi dari variabel menunjukkan tindakan yang harus dilakukan jika file tidak atau belum ada. Untuk informasi selengkapnya tentang bit ini, lihat deskripsi parameter CreateDisposition dari ZwCreateFile.

Parameter ini bersifat opsional dan dapat berupa NULL.

[out, optional] pFileAttributes

Penunjuk ke variabel yang dialokasikan penelepon yang menerima bendera bit yang menunjukkan atribut file. Bendera bit bernama FILE_ATTRIBUTE_XXXX ini didefinisikan dalam Wdm.h. Untuk informasi selengkapnya tentang bendera bit ini, lihat deskripsi parameter FileAttributes dari ZwCreateFile.

Parameter ini bersifat opsional dan dapat berupa NULL.

[out, optional] pShareAccess

Penunjuk ke variabel yang dialokasikan penelepon yang menerima bendera bit yang menunjukkan opsi berbagi file. Bendera bit bernama FILE_SHARE_XXXX ini didefinisikan dalam Wdm.h. Untuk informasi selengkapnya tentang bendera bit ini, lihat deskripsi parameter ShareAccess dari ZwCreateFile.

Parameter ini bersifat opsional dan dapat berupa NULL.

[out, optional] pDesiredAccess

Penunjuk ke struktur ACCESS_MASK yang dialokasikan penelepon yang menentukan akses yang diminta ke file. Untuk informasi selengkapnya tentang parameter ini, lihat parameter DesiredAccess dari ZwCreateFile.

Parameter ini bersifat opsional dan dapat berupa NULL.

Nilai kembali

Tidak ada

Keterangan

Setelah kerangka kerja memanggil fungsi panggilan balik IQueueCallbackCreate::OnCreateFile driver, driver dapat memanggil metode IWDFIoRequest::GetCreateParameters atau metode IWDFIoRequest2::GetCreateParametersEx untuk mendapatkan parameter pembuatan file.

Untuk informasi selengkapnya, lihat Mendapatkan Parameter untuk Permintaan I/O.

Contoh

Contoh kode berikut menunjukkan bagaimana fungsi panggilan balik IQueueCallbackCreate::OnCreateFile dapat memperoleh antarmuka IWDFIoRequest2 lalu memanggil GetCreateParametersEx.

VOID
OnCreateFile(
    __in IWDFIoQueue* FxQueue,
    __in IWDFIoRequest* FxRequest,
    __in IWDFFile* FxFile
    )
{
    ULONG fileOptions;
    USHORT fileAttributes,
    USHORT shareAccess,
    ACCESS_MASK desiredAccess;
    ...
    CComQIPtr<IWDFIoRequest2> fxRequest2(FxRequest);
    fxRequest2->GetCreateParametersEx(&fileOptions
                                      &fileAttributes,
                                      &shareAccess,
                                      &desiredAccess);
    ...
}

Persyaratan

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

Lihat juga

IQueueCallbackCreate::OnCreateFile

IWDFIoRequest2

IWDFIoRequest::GetCreateParameters