Fungsi WdfDeviceAllocAndQueryInterfaceProperty (wdfdevice.h)
[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 |
---|---|
|
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
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk