EVT_WDF_DEVICE_SELF_MANAGED_IO_INIT fungsi panggilan balik (wdfdevice.h)

Artikel
02/29/2024

[Berlaku untuk KMDF dan UMDF]

Fungsi panggilan balik peristiwa EvtDeviceSelfManagedIoInit driver menginisialisasi dan memulai operasi I/O yang dikelola sendiri perangkat.

Sintaks

EVT_WDF_DEVICE_SELF_MANAGED_IO_INIT EvtWdfDeviceSelfManagedIoInit;

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

Parameter

[in] Device

Handel ke objek perangkat kerangka kerja.

Nilai kembali

Jika fungsi panggilan balik EvtDeviceSelfManagedIoInit 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(status) sama dengan FALSE. Jika NT_SUCCESS(status) sama dengan FALSE, kerangka kerja tidak memulai 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 EvtDeviceSelfManagedIoInit , driver harus memanggil WdfDeviceInitSetPnpowerEventCallbacks.

Jika driver telah mendaftarkan fungsi panggilan balik EvtDeviceSelfManagedIoInit , kerangka kerja memanggilnya sekali untuk setiap perangkat, setelah kerangka kerja memanggil fungsi panggilan balik EvtDeviceD0Entry driver untuk pertama kalinya. Kerangka kerja tidak memanggil fungsi panggilan balik EvtDeviceSelfManagedIoInit lagi untuk perangkat tersebut, kecuali perangkat dihapus dan disambungkan kembali, atau driver dimuat ulang.

Fungsi panggilan balik EvtDeviceSelfManagedIoInit harus menginisialisasi dan memulai operasi I/O yang dikelola sendiri yang akan ditangani driver untuk 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.