EVT_WDF_DEVICE_SELF_MANAGED_IO_RESTART fungsi panggilan balik (wdfdevice.h)

  • Artikel

[Berlaku untuk KMDF dan UMDF]

Fungsi panggilan balik peristiwa EvtDeviceSelfManagedIoRestart driver memulai ulang operasi I/O yang dikelola sendiri oleh perangkat.

Sintaks

EVT_WDF_DEVICE_SELF_MANAGED_IO_RESTART EvtWdfDeviceSelfManagedIoRestart;

NTSTATUS EvtWdfDeviceSelfManagedIoRestart(
  [in] WDFDEVICE Device
)
{...}

Parameter

[in] Device

Handel ke objek perangkat kerangka kerja.

Nilai kembali

Jika fungsi panggilan balik EvtDeviceSelfManagedIoRestart tidak mengalami kesalahan, fungsi tersebut harus mengembalikan STATUS_SUCCESS, atau nilai status lain yang NT_SUCCESS(statusnya) sama dengan TRUE. Jika tidak, itu harus mengembalikan nilai status yang NT_SUCCESS(status) sama dengan FALSE. Jika NT_SUCCESS(status) sama dengan FALSE, kerangka kerja akan menghentikan perangkat dan membongkar driver perangkat.

Jika NT_SUCCESS(status) sama dengan FALSE, kerangka kerja memanggil fungsi panggilan balik EvtDeviceSelfManagedIoFlush driver dan EvtDeviceSelfManagedIoCleanup .

Untuk informasi selengkapnya tentang nilai pengembalian fungsi panggilan balik ini, lihat Melaporkan Kegagalan Perangkat.

Keterangan

Untuk mendaftarkan fungsi panggilan balik EvtDeviceSelfManagedIoRestart , driver harus memanggil WdfDeviceInitSetPnpowerEventCallbacks.

Jika driver telah mendaftarkan fungsi panggilan balik EvtDeviceSelfManagedIoRestart , kerangka kerja memanggilnya setiap kali perangkat kembali dari status daya rendah ke status kerja (D0). Kerangka kerja memanggil fungsi panggilan balik EvtDeviceSelfManagedIoRestart hanya setelah memanggil fungsi panggilan balik EvtDeviceSelfManagedIoSuspend driver.

Fungsi panggilan balik EvtDeviceSelfManagedIoRestart driver harus melakukan apa pun yang diperlukan untuk melanjutkan operasi I/O yang dikelola sendiri perangkat.

Untuk informasi selengkapnya tentang kapan kerangka kerja memanggil fungsi panggilan balik ini, lihat Skenario PnP dan Power Management.

Untuk informasi selengkapnya tentang driver yang menyediakan fungsi panggilan balik ini, lihat Menggunakan I/O Self-Managed.

Fungsi panggilan balik EvtDeviceSelfManagedIoRestart dipanggil di IRQL = PASSIVE_LEVEL. Anda tidak boleh membuat fungsi panggilan balik ini dapat di-pageable.

Persyaratan

Persyaratan Nilai
Target Platform Universal
Versi KMDF minimum 1,0
Versi UMDF minimum 2.0
Header wdfdevice.h (termasuk Wdf.h)
IRQL PASSIVE_LEVEL (lihat bagian Keterangan)

Lihat juga

EvtDeviceSelfManagedIoCleanup

EvtDeviceSelfManagedIoFlush

EvtDeviceSelfManagedIoInit

EvtDeviceSelfManagedIoSuspend