EVT_WDF_DEVICE_SELF_MANAGED_IO_RESTART fungsi panggilan balik (wdfdevice.h)

[Berlaku untuk KMDF dan UMDF]

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

Sintaks

EVT_WDF_DEVICE_SELF_MANAGED_IO_RESTART EvtWdfDeviceSelfManagedIoRestart;

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

Parameter

[in] Device

Handel ke objek perangkat kerangka kerja.

Mengembalikan nilai

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, nilai status harus dikembalikan yang NT_SUCCESS(statusnya) 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 dan EvtDeviceSelfManagedIoCleanup driver.

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 Manajemen PnP dan Power.

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

   
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