Fungsi WdfDeviceAllocAndQueryPropertyEx (wdfdevice.h)

  • Artikel

[Berlaku untuk KMDF dan UMDF]

Metode WdfDeviceAllocAndQueryPropertyEx mengalokasikan buffer dan mengambil properti perangkat tertentu.

Sintaks

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 berjenis POOL_TYPE yang menentukan jenis memori yang akan dialokasikan.

[in, optional] PropertyMemoryAttributes

Penunjuk ke struktur WDF_OBJECT_ATTRIBUTES yang dialokasikan penelepon 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.

Nilai kembali

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

Menampilkan 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.

Keterangan

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

Persyaratan Nilai
Target Platform 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