Fungsi WdfDeviceAllocAndQueryInterfaceProperty (wdfdevice.h)

Artikel
08/08/2023

[Hanya berlaku untuk UMDF]

Metode WdfDeviceAllocAndQueryInterfaceProperty mengalokasikan buffer dan mengambil properti antarmuka perangkat tertentu.

Sintaks

NTSTATUS WdfDeviceAllocAndQueryInterfaceProperty(
  [in]           WDFDEVICE                           Device,
  [in]           PWDF_DEVICE_INTERFACE_PROPERTY_DATA PropertyData,
  [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] PropertyData

Penunjuk ke struktur WDF_DEVICE_INTERFACE_PROPERTY_DATA yang mengidentifikasi properti antarmuka perangkat yang akan diambil.

[in] PoolType

Enumerator jenis 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 yang diketik DEVPROPTYPE yang, saat dikembalikan, mengidentifikasi jenis data properti yang terkandung dalam PropertyMemory.

Nilai kembali

Jika metode WdfDeviceAllocAndQueryInterfaceProperty tidak mengalami kesalahan, metode mengembalikan STATUS_SUCCESS. Nilai pengembalian tambahan meliputi:

Menampilkan kode	Deskripsi
STATUS_INVALID_PARAMETER	Salah satu parameter salah.

Metode ini mungkin mengembalikan nilai NTSTATUS lainnya.

Keterangan

Metode WdfDeviceAllocAndQueryInterfaceProperty 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
Klien minimum yang didukung	Windows 8.1
Target Platform	Universal
Versi UMDF minimum	2.0
Header	wdfdevice.h (termasuk Wdf.h)
Pustaka	WUDFx02000.lib
DLL	WUDFx02000.dll
IRQL	PASSIVE_LEVEL

Lihat juga

WDF_DEVICE_INTERFACE_PROPERTY_DATA

WDF_DEVICE_INTERFACE_PROPERTY_DATA_INIT

WdfDeviceAssignInterfaceProperty

WdfDeviceQueryInterfaceProperty

Bagikan melalui