Fungsi WdfDeviceWdmGetAttachedDevice (wdfdevice.h)

Artikel
02/27/2024

[Hanya berlaku untuk KMDF]

Metode WdfDeviceWdmGetAttachedDevice mengembalikan objek perangkat WDM yang lebih rendah berikutnya di tumpukan perangkat.

Sintaks

PDEVICE_OBJECT WdfDeviceWdmGetAttachedDevice(
  [in] WDFDEVICE Device
);

Parameter

[in] Device

Handel ke objek perangkat kerangka kerja.

Nilai kembali

WdfDeviceWdmGetAttachedDevice mengembalikan pointer ke struktur DEVICE_OBJECT WDM. Jika handel objek yang ditentukan mewakili objek perangkat fisik (PDO), metode mengembalikan NULL.

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

Keterangan

Penunjuk yang dikembalikan metode WdfDeviceWdmGetAttachedDevice valid hingga objek perangkat kerangka kerja dihapus. Jika driver menyediakan fungsi EvtCleanupCallback untuk objek perangkat kerangka kerja, penunjuk valid hingga fungsi panggilan balik kembali.

Contoh

Contoh kode berikut membuat pesan pelacakan yang berisi pointer ke objek perangkat WDM yang mewakili PDO, FDO, dan perangkat yang lebih rendah perangkat berikutnya.

TraceEvents(
            TRACE_LEVEL_INFORMATION,
            DBG_PNP,
            "PDO(0x%p) FDO(0x%p), Lower(0x%p)\n",
            WdfDeviceWdmGetPhysicalDevice(device),
            WdfDeviceWdmGetDeviceObject(device),
            WdfDeviceWdmGetAttachedDevice(device)
            );

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

WdfDeviceWdmGetDeviceObject

WdfDeviceWdmGetPhysicalDevice

Bagikan melalui