Bagikan melalui

Metode IWDFIoRequest::GetCreateParameters (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 GetCreateParameters mengambil parameter permintaan untuk permintaan jenis buat.

Sintaks

void GetCreateParameters(
  [out, optional] ULONG  *pOptions,
  [out, optional] USHORT *pFileAttributes,
  [out, optional] USHORT *pShareAccess
);

Parameter

[out, optional] pOptions

Penunjuk ke variabel yang menerima bitmask bendera yang menentukan opsi yang diterapkan saat membuat atau membuka file yang terkait dengan permintaan dan tindakan yang akan diambil jika file sudah ada.

8 bit tinggi dari parameter ini sesuai dengan parameter CreateDisposition dari fungsi ZwCreateFile mode kernel. 8 bit ini menentukan tindakan yang akan diambil, tergantung pada apakah file sudah ada. Perhatikan bahwa nilai disposisi ini berbeda dari nilai yang digunakan dalam parameter dwCreationDisposition dari fungsi Win32 CreateFile .

24 bit rendah dari parameter ini sesuai dengan parameter CreateOptions dari ZwCreateFile.

Parameter ini bersifat opsional. Driver dapat melewati NULL jika driver tidak memerlukan informasi.

[out, optional] pFileAttributes

Penunjuk ke variabel yang menerima bitmask bendera atribut yang diterapkan saat membuat atau membuka file yang terkait dengan permintaan. Atribut yang ditentukan secara eksplisit hanya diterapkan saat file dibuat, digantikan, atau, dalam beberapa situasi, ditimpa. Secara default, bendera FILE_ATTRIBUTE_NORMAL tunggal ditentukan. Namun, bendera ini dapat ditimpa oleh bendera lain atau dengan kombinasi bitwise ATAU dari bendera yang kompatibel. Bitmask bendera atribut sesuai dengan parameter FileAttributes dari ZwCreateFile.

Parameter ini bersifat opsional. Driver dapat melewati NULL jika driver tidak memerlukan informasi.

[out, optional] pShareAccess

Penunjuk ke variabel yang menerima bitmask bendera yang menentukan hak akses berbagi yang diminta untuk file yang terkait dengan permintaan. Jika bitmask yang diterima adalah nol, akses eksklusif sedang diminta. Untuk informasi selengkapnya tentang akses berbagi, lihat deskripsi parameter ShareAccess dari ZwCreateFile.

Parameter ini bersifat opsional. Driver dapat melewati NULL jika driver tidak memerlukan informasi.

Nilai kembali

Tidak ada

Keterangan

Meskipun driver dapat secara opsional menentukan NULL untuk setiap parameter pOptions, pFileAttributes, dan pShareAccess, driver harus menentukan setidaknya satu parameter non-NULL agar GetCreateParameters berhasil dijalankan.

Persyaratan

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

Lihat juga

IWDFIoRequest

ZwCreateFile