EVT_WDF_DEVICE_SELF_MANAGED_IO_INIT fungsi panggilan balik (wdfdevice.h)

[Berlaku untuk KMDF dan UMDF]

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

Sintaks

EVT_WDF_DEVICE_SELF_MANAGED_IO_INIT EvtWdfDeviceSelfManagedIoInit;

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

Parameter

[in] Device

Handel ke objek perangkat kerangka kerja.

Mengembalikan nilai

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, itu harus mengembalikan nilai status 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 driver dan EvtDeviceSelfManagedIoCleanup .

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

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

Persyaratan

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

Lihat juga

EvtDeviceSelfManagedIoCleanup

EvtDeviceSelfManagedIoFlush

EvtDeviceSelfManagedIoRestart

EvtDeviceSelfManagedIoSuspend