Fungsi WdfPdoAddEjectionRelationsPhysicalDevice (wdfpdo.h)

Artikel
02/29/2024

[Hanya berlaku untuk KMDF]

Metode WdfPdoAddEjectionRelationsPhysicalDevice menunjukkan bahwa perangkat tertentu dikeluarkan ketika perangkat lain yang ditentukan dikeluarkan.

Sintaks

NTSTATUS WdfPdoAddEjectionRelationsPhysicalDevice(
  [in] WDFDEVICE      Device,
  [in] PDEVICE_OBJECT PhysicalDevice
);

Parameter

[in] Device

Handel ke objek perangkat kerangka kerja.

[in] PhysicalDevice

Penunjuk ke struktur DEVICE_OBJECT yang disediakan penelepon yang mewakili objek perangkat fisik (PDO).

Nilai kembali

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

Menampilkan kode	Deskripsi
STATUS_INVALID_PARAMETER	Parameter input adalah NULL.
STATUS_INSUFFICIENT_RESOURCES	Alokasi memori gagal.

Metode ini mungkin juga mengembalikan nilai NTSTATUS lainnya.

Pemeriksaan bug sistem terjadi jika driver memasok handel objek yang tidak valid.

Keterangan

Parameter PhysicalDevice menunjuk ke PDO perangkat yang dikeluarkan saat perangkat yang diidentifikasi oleh Perangkat dikeluarkan. Biasanya, kedua perangkat dikendalikan oleh driver panggilan. Jangan melaporkan perangkat turunan Perangkat karena ketika manajer PnP mengeluarkan perangkat induk, ia juga mengeluarkan turunan perangkat.

Untuk informasi selengkapnya, lihat Mendukung Perangkat yang Dapat Dikeluarkan.

Contoh

Contoh kode berikut menambahkan perangkat yang diwakili struktur pPhysicalDeviceObject ke daftar perangkat yang dikeluarkan saat perangkat yang ditentukan perangkat dikeluarkan.

PDEVICE_OBJECT  pPhysicalDeviceObject;
NTSTATUS  status;
...
status = WdfPdoAddEjectionRelationsPhysicalDevice(
 device,
 pPhysicalDeviceObject
                                                  );

Persyaratan

Persyaratan	Nilai
Target Platform	Universal
Versi KMDF minimum	1,0
Header	wdfpdo.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

WdfPdoClearEjectionRelationsDevices

WdfPdoRemoveEjectionRelationsPhysicalDevice

Bagikan melalui