IPort::Metode GetDeviceProperty (portcls.h)

Metode GetDeviceProperty menyediakan akses yang disederhanakan ke properti perangkat yang terkandung dalam registri untuk perangkat Plug and Play.

Sintaks

NTSTATUS GetDeviceProperty(
  DEVICE_REGISTRY_PROPERTY DeviceProperty,
  ULONG                    BufferLength,
  PVOID                    PropertyBuffer,
  PULONG                   ResultLength
);

Parameter

DeviceProperty

Mengidentifikasi properti perangkat tertentu yang diminta pemanggil. Nilai yang valid untuk parameter ini sama dengan yang ditentukan untuk parameter DeviceProperty panggilan IoGetDeviceProperty.

BufferLength

Menentukan panjang dalam byte buffer yang akan menerima informasi yang diminta.

PropertyBuffer

Penunjuk ke buffer properti. Parameter ini menunjuk ke buffer yang dialokasikan pemanggil tempat metode menulis informasi properti yang diminta. Buffer harus cukup besar untuk memuat jumlah byte yang ditentukan dalam BufferLength.

ResultLength

Penunjuk output ke panjang data yang dikembalikan. Parameter ini menunjuk ke variabel ULONG yang dialokasikan pemanggil tempat metode menulis hitungan yang menentukan jumlah byte yang benar-benar ditulis ke buffer PropertyBuffer. Namun, jika buffer terlalu kecil untuk berisi informasi, metode ini menghasilkan ukuran buffer yang diperlukan.

Mengembalikan nilai

Metode ini mengembalikan NTSTATUS yang berisi STATUS_SUCCESS jika panggilan berhasil. Jika tidak, metode mengembalikan kode kesalahan yang sesuai. Jika buffer properti yang disediakan oleh pemanggil terlalu kecil, metode akan mengembalikan STATUS_BUFFER_TOO_SMALL dan menghasilkan ukuran yang diperlukan di ReturnLength.

Keterangan

Metode ini mengambil properti perangkat adaptor audio. Ini mirip dalam operasi dengan fungsi PcGetDeviceProperty, kecuali bahwa ia secara otomatis mengambil properti perangkat adaptor audio daripada mengharuskan objek perangkat untuk secara eksplisit menentukan perangkat target.

Persyaratan

Persyaratan	Nilai
Header	portcls.h
IRQL	PASSIVE_LEVEL

Lihat juga

IPort