IOCTL_USB_REGISTER_FOR_TRANSPORT_CHARACTERISTICS_CHANGE IOCTL (usbioctl.h)

Artikel
02/26/2024

Permintaan ini mendaftar untuk pemberitahuan tentang perubahan karakteristik transportasi.

Kode utama

Buffer Input/Output

Anggota AssociatedIrp.SystemBuffer adalah penunjuk ke struktur USB_TRANSPORT_CHARACTERISTICS_CHANGE_REGISTRATION . Pada input, driver klien dapat menentukan jenis perubahan pemberitahuan di mana driver tertarik dengan mengatur bendera di anggota ChangeNotificationInputFlags .

Pada output, struktur diisi dengan handel pendaftaran dan nilai awal karakteristik transportasi.

Panjang buffer Input/Output

Ukuran struktur USB_TRANSPORT_CHARACTERISTICS_CHANGE_REGISTRATION .

Blok status

Irp->IoStatus.Status diatur ke STATUS_SUCCESS jika permintaan berhasil. Jika tidak, Status menunjukkan kondisi kesalahan yang sesuai sebagai kode NTSTATUS .

Keterangan

Karakteristik transportasi media MA-USB dapat bervariasi secara signifikan dari waktu ke waktu. Jika penyelam klien tertarik untuk mengetahui informasi terbaru setiap saat, driver harus mendaftar untuk pemberitahuan dengan mengirim permintaan.

Permintaan ini dapat dikirim oleh aplikasi mode pengguna, driver UMDF, atau driver KMDF. Pemeriksaan tumpukan driver USB untuk handel pendaftaran kedaluarsa dan buruk. Jika permintaan diterima pada handel sebelum pendaftaran dan setelah membatalkan pendaftaran, tumpukan driver gagal permintaan.