Fungsi WdfDeviceInitFree (wdfdevice.h)

  • Artikel

[Berlaku untuk KMDF saja]

Metode WdfDeviceInitFree membatalkan struktur WDFDEVICE_INIT .

Sintaks

void WdfDeviceInitFree(
  [in] PWDFDEVICE_INIT DeviceInit
);

Parameter

[in] DeviceInit

Penunjuk ke struktur WDFDEVICE_INIT .

Nilai kembali

Tidak ada

Keterangan

Jika driver Anda menerima struktur WDFDEVICE_INIT dari panggilan ke WdfPdoInitAllocate atau WdfControlDeviceInitAllocate, dan jika driver kemudian mengalami kesalahan ketika memanggil metode inisialisasi objek perangkat atau WdfDeviceCreate, driver harus memanggil WdfDeviceInitFree.

Driver Anda tidak boleh memanggil WdfDeviceInitFree setelah berhasil memanggil WdfDeviceCreate .

Driver Anda tidak perlu memanggil WdfDeviceInitFree jika menerima struktur WDFDEVICE_INIT sebagai input ke fungsi panggilan balik EvtDriverDeviceAdd , karena kerangka kerja menghapus struktur setelah fungsi panggilan balik kembali.

Untuk informasi selengkapnya tentang memanggil WdfDeviceCreate, lihat Membuat Objek Perangkat Kerangka Kerja.

Contoh

Contoh kode berikut memanggil WdfDeviceInitFree jika panggilan ke WdfPdoInitAssignRawDevice gagal.

NTSTATUS  status;

status = WdfPdoInitAssignRawDevice(
                                   pDeviceInit,
                                   &GUID_DEVCLASS_KEYBOARD
                                   );
if (!NT_SUCCESS(status)) {
    WdfDeviceInitFree(pDeviceInit);
    pDeviceInit = NULL;
    return STATUS;
}

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 DoubleDeviceInitFree(kmdf), DriverCreate(kmdf), InitFreeDeviceCallback(kmdf), InitFreeDeviceCreate(kmdf), InitFreeDeviceCreateType2(kmdf), InitFreeDeviceCreateType4(kmdf), InitFreeNull(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoInitFreeDeviceCallback(kmdf), PdoInitFreeDeviceCreate(kmdf), PdoInitFreeDeviceCreateType2(kmdf), PdoInitFreeDeviceCreateType4(kmdf)

Lihat juga

WdfDeviceCreate