Fungsi WdfPdoAddEjectionRelationsPhysicalDevice (wdfpdo.h)

[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