Fungsi WdfDeviceAllocAndQueryPropertyEx (wdfdevice.h)

Artikel
07/02/2025

[Berlaku untuk KMDF dan UMDF]

Metode WdfDeviceAllocAndQueryPropertyEx mengalokasikan buffer dan mengambil properti perangkat tertentu.

Sintaksis

NTSTATUS WdfDeviceAllocAndQueryPropertyEx(
  [in]           WDFDEVICE                 Device,
  [in]           PWDF_DEVICE_PROPERTY_DATA DeviceProperty,
  [in]           POOL_TYPE                 PoolType,
  [in, optional] PWDF_OBJECT_ATTRIBUTES    PropertyMemoryAttributes,
  [out]          WDFMEMORY                 *PropertyMemory,
  [out]          PDEVPROPTYPE              Type
);

Parameter

[in] Device

Handel ke objek perangkat kerangka kerja.

[in] DeviceProperty

Penunjuk ke struktur WDF_DEVICE_PROPERTY_DATA yang mengidentifikasi properti perangkat yang akan diambil.

[in] PoolType

Enumerator POOL_TYPE-typed yang menentukan jenis memori yang akan dialokasikan.

[in, optional] PropertyMemoryAttributes

Penunjuk ke struktur WDF_OBJECT_ATTRIBUTES yang dialokasikan pemanggil yang menjelaskan atribut objek untuk objek memori yang akan dialokasikan fungsi. Parameter ini bersifat opsional dan dapat WDF_NO_OBJECT_ATTRIBUTES.

[out] PropertyMemory

Penunjuk ke lokasi yang diketik WDFMEMORY yang menerima handel ke objek memori kerangka kerja.

[out] Type

Penunjuk ke variabel DEVPROPTYPE. Jika metode berhasil, setelah mengembalikan parameter ini berisi nilai jenis properti dari data properti yang disimpan di PropertyMemory.

Mengembalikan nilai

Jika operasi berhasil, WdfDeviceAllocAndQueryPropertyEx mengembalikan STATUS_SUCCESS. Nilai pengembalian tambahan meliputi:

Mengembalikan kode	Deskripsi
STATUS_INVALID_PARAMETER	Nilai DeviceProperty yang ditentukan tidak valid.

Metode ini mungkin mengembalikan nilai NTSTATUS lainnya.

Pemeriksaan bug terjadi jika driver menyediakan handel objek yang tidak valid.

Komentar

Anda dapat menggunakan WdfDeviceAllocAndQueryPropertyEx untuk mengambil properti apa pun yang diekspos melalui model properti terpadu, sedangkan metode WdfDeviceAllocAndQueryProperty hanya memungkinkan kueri subset model properti terpadu.

Metode WdfDeviceAllocAndQueryPropertyEx menentukan jumlah memori yang diperlukan untuk menahan properti antarmuka perangkat yang diminta. Ini mengalokasikan memori yang cukup untuk menyimpan data, dan mengembalikan handel ke objek memori kerangka kerja yang menjelaskan memori yang dialokasikan. Untuk mengakses data, driver Anda dapat memanggil WdfMemoryGetBuffer.

Untuk informasi tentang metode terkait, lihat Mengakses Model Properti Perangkat Terpadu.

Persyaratan

Syarat	Nilai
Platform Target	Universal
versi KMDF Minimum	1.13
versi UMDF Minimum	2.0
Header	wdfdevice.h (termasuk Wdf.h)
Pustaka	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	APC_LEVEL

Lihat juga

WdfDeviceAllocAndQueryInterfaceProperty

WdfDeviceAllocAndQueryProperty

Bagikan melalui