EVT_UDECX_USB_DEVICE_D0_EXIT fungsi panggilan balik (udecxusbdevice.h)

  • Artikel

Ekstensi kelas emulasi perangkat USB (UdeCx) memanggil fungsi panggilan balik ini ketika mendapat permintaan untuk mengirim perangkat USB virtual ke status daya rendah.

Sintaks

EVT_UDECX_USB_DEVICE_D0_EXIT EvtUdecxUsbDeviceD0Exit;

NTSTATUS EvtUdecxUsbDeviceD0Exit(
  [in] WDFDEVICE UdecxWdfDevice,
  [in] UDECXUSBDEVICE UdecxUsbDevice,
  [in] UDECX_USB_DEVICE_WAKE_SETTING WakeSetting
)
{...}

Parameter

[in] UdecxWdfDevice

Handel ke objek perangkat kerangka kerja yang mewakili pengontrol tempat perangkat USB terpasang. Driver klien menginisialisasi objek ini dalam panggilan sebelumnya ke UdecxWdfDeviceAddUsbDeviceEmulation.

[in] UdecxUsbDevice

Handel ke objek perangkat UDE. Driver klien membuat objek ini dalam panggilan sebelumnya ke UdecxUsbDeviceCreate.

[in] WakeSetting

Nilai jenis UDECX_USB_DEVICE_WAKE_SETTING yang menunjukkan kemampuan bangun jarak jauh perangkat USB.

Nilai kembali

Jika operasi berhasil, fungsi panggilan balik harus mengembalikan STATUS_SUCCESS, atau nilai status lain yang NT_SUCCESS(status) sama dengan TRUE.

Keterangan

Driver klien mendaftarkan fungsi dalam panggilan sebelumnya ke UdecxUsbDeviceInitSetStateChangeCallbacks dengan menyediakan pointer fungsi ke implementasinya.

Dalam implementasi panggilan balik, driver klien untuk perangkat USB diharapkan untuk melakukan langkah-langkah untuk mengirim perangkat ke status daya rendah. Dalam fungsi ini, driver dapat memulai bangun dari status daya tautan rendah, fungsi ditangguhkan, atau keduanya. Untuk melakukannya, driver untuk perangkat USB 2.0 harus memanggil metode UdecxUsbDeviceSignalWake . Perangkat USB 3.0 harus menggunakan UdecxUsbDeviceSignalFunctionWake.

Permintaan daya dapat diselesaikan secara asinkron dengan mengembalikan STATUS_PENDING, dan kemudian memanggil UdecxUsbDeviceLinkPowerExitComplete dengan kode penyelesaian aktual.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 10
Server minimum yang didukung Server Windows 2016
Target Platform Windows
Versi KMDF minimum 1.15
Header udecxusbdevice.h (termasuk Udecx.h)
IRQL <=DISPATCH_LEVEL

Lihat juga

Arsitektur: Emulasi Perangkat USB (UDE)

EVT_UDECX_USB_DEVICE_D0_ENTRY

UdecxUsbDeviceLinkPowerExitComplete

UdecxUsbDeviceSignalWake

Menulis driver klien UDE