Fungsi WdfPdoInitAllocate (wdfpdo.h)

  • Artikel

[Hanya berlaku untuk KMDF]

Metode WdfPdoInitAllocate mengalokasikan struktur WDFDEVICE_INIT untuk driver bus berbasis kerangka kerja, yang digunakan pengemudi bus saat melaporkan perangkat baru.

Sintaks

PWDFDEVICE_INIT WdfPdoInitAllocate(
  [in] WDFDEVICE ParentDevice
);

Parameter

[in] ParentDevice

Handel ke objek perangkat kerangka kerja yang mewakili perangkat induk perangkat baru. Objek perangkat kerangka kerja harus mewakili objek perangkat fungsi (FDO).

Nilai kembali

Jika operasi berhasil, metode mengembalikan penunjuk ke struktur WDFDEVICE_INIT yang dialokasikan kerangka kerja. Jika tidak, metode mengembalikan NULL.

Keterangan

Jika driver bus menggunakan enumerasi statis, ia melaporkan perangkat baru dengan:

  1. Memanggil WdfPdoInitAllocate untuk mengalokasikan struktur WDFDEVICE_INIT .
  2. Memanggil metode inisialisasi objek perangkat kerangka kerja dan metode inisialisasi PDO kerangka kerja, sesuai kebutuhan, untuk menginisialisasi struktur WDFDEVICE_INIT. Jika panggilan ke salah satu metode ini gagal, driver harus memanggil WdfDeviceInitFree.
  3. Memanggil WdfDeviceCreate untuk membuat objek perangkat kerangka kerja, menyediakan struktur WDFDEVICE_INIT yang diinisialisasi sebagai input.
Untuk informasi selengkapnya tentang enumerasi statis, lihat Menghitung Perangkat di Bus.

Contoh

Untuk contoh kode yang menggunakan WdfPdoInitAllocate, lihat WdfFdoAddStaticChild.

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 PASSIVE_LEVEL
Aturan kepatuhan DDI AddPdoToStaticChildList(kmdf), DoubleDeviceInitFree(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf), PdoInitFreeDeviceCallback(kmdf), PdoInitFreeDeviceCreate(kmdf), PdoInitFreeDeviceCreateType2(kmdf), PdoInitFreeDeviceCreateType4(kmdf)

Lihat juga

WdfControlDeviceInitAllocate