Fungsi WdfDeviceAddDependentUsageDeviceObject (wdfdevice.h)

  • Artikel

[Berlaku untuk KMDF saja]

Metode WdfDeviceAddDependentUsageDeviceObject menunjukkan bahwa perangkat tertentu bergantung pada perangkat lain ketika perangkat yang ditentukan digunakan untuk menyimpan file khusus.

Sintaks

NTSTATUS WdfDeviceAddDependentUsageDeviceObject(
  [in] WDFDEVICE      Device,
  [in] PDEVICE_OBJECT DependentDevice
);

Parameter

[in] Device

Handel ke objek perangkat kerangka kerja.

[in] DependentDevice

Penunjuk ke struktur DEVICE_OBJECT yang disediakan penelepon yang mengidentifikasi perangkat yang bergantung pada Perangkat .

Nilai kembali

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

Menampilkan kode Deskripsi
STATUS_INVALID_PARAMETER
 DependentDeviceADALAH NULL.
STATUS_INSUFFICIENT_RESOURCES
 Alokasi memori gagal.
 

Metode ini mungkin mengembalikan nilai NTSTATUS lainnya.

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

Keterangan

Driver Anda dapat memanggil WdfDeviceAddDependentUsageDeviceObject untuk menunjukkan bahwa perangkat yang diidentifikasi oleh Perangkat tergantung pada perangkat yang diidentifikasi oleh DependentDevice, saat Perangkat mendukung file khusus. Jika driver Anda memanggil fungsi panggilan balik WdfDeviceAddDependentUsageDeviceObject, kerangka kerja memanggil fungsi panggilan balik EvtDeviceUsageNotification di driver DependentDevice sebelum memanggil fungsi panggilan balik EvtDeviceUsageNotification di driver Perangkat.

Driver Anda dapat memanggil WdfDeviceAddDependentUsageDeviceObject beberapa kali untuk mengidentifikasi beberapa perangkat yang bergantung pada Perangkat untuk mendukung file khusus.

Setelah driver memanggil WdfDeviceAddDependentUsageDeviceObject, driver dapat memanggil WdfDeviceRemoveDependentUsageDeviceObject untuk menghapus perangkat yang diidentifikasi oleh DependentDevice dari daftar perangkat yang bergantung pada Perangkat .

Untuk informasi selengkapnya tentang file khusus, lihat Mendukung File Khusus.

Contoh

Contoh kode berikut menambahkan perangkat (pDeviceObject) ke daftar perangkat yang bergantung pada perangkat lain (Perangkat).

status = WdfDeviceAddDependentUsageDeviceObject(
                                                device,
                                                pDeviceObject
                                                );

Persyaratan

Persyaratan Nilai
Target Platform Universal
Versi KMDF minimum 1,0
Header wdfdevice.h (termasuk Wdf.h)
Pustaka Wdf01000.sys (lihat Penerapan Versi Pustaka Kerangka Kerja.)
IRQL <= DISPATCH_LEVEL
Aturan kepatuhan DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Lihat juga

EvtDeviceUsageNotification

WdfDeviceRemoveDependentUsageDeviceObject