Header ucxusbdevice.h
Header ini digunakan untuk menulis driver pengontrol host USB. Ekstensi pengontrol host USB adalah driver yang disediakan sistem (Ucx01000.sys). Driver ini diimplementasikan sebagai ekstensi kelas kerangka kerja dengan menggunakan antarmuka pemrograman Windows Driver Framework. Driver pengontrol host berfungsi sebagai driver klien ke ekstensi kelas tersebut. Sementara driver pengontrol host menangani operasi dan peristiwa perangkat keras, manajemen daya, dan peristiwa PnP, UCX berfungsi sebagai antarmuka abstrak yang mengantre permintaan ke driver pengontrol host, dan melakukan tugas lain.
Jangan sertakan header ini secara langsung. Sebagai gantinya, sertakan Ucxclass.h
Untuk informasi selengkapnya, lihat:
ucxusbdevice.h berisi antarmuka pemrograman berikut:
Fungsi
| UCX_USBDEVICE_EVENT_CALLBACKS_INIT Menginisialisasi struktur UCX_USBDEVICE_EVENT_CALLBACKS dengan penunjuk fungsi ke fungsi panggilan balik driver klien. |
| UcxUsbDeviceBuat Membuat objek perangkat USB pada pengontrol yang ditentukan. |
| UcxUsbDeviceInitSetEventCallbacks Menginisialisasi struktur UCXUSBDEVICE_INIT dengan fungsi panggilan balik peristiwa driver klien. |
| UcxUsbDeviceRemoteWakeNotification Memberi tahu UCX bahwa sinyal bangun jarak jauh dari perangkat diterima. |
Fungsi panggilan balik
| EVT_UCX_USBDEVICE_ADDRESS Implementasi driver klien yang dipanggil UCX untuk mengatasi perangkat USB. |
| EVT_UCX_USBDEVICE_DEFAULT_ENDPOINT_ADD Implementasi driver klien yang dipanggil UCX untuk menambahkan titik akhir default baru untuk perangkat USB. |
| EVT_UCX_USBDEVICE_DISABLE Implementasi driver klien yang dipanggil UCX untuk merilis sumber daya pengontrol yang terkait dengan perangkat dan titik akhir defaultnya. |
| EVT_UCX_USBDEVICE_ENABLE Implementasi driver klien yang dipanggil UCX untuk memprogram informasi tentang perangkat dan titik akhir kontrol defaultnya ke pengontrol. |
| EVT_UCX_USBDEVICE_ENDPOINT_ADD Implementasi driver klien yang dipanggil UCX untuk menambahkan titik akhir baru untuk perangkat USB. |
| EVT_UCX_USBDEVICE_ENDPOINTS_CONFIGURE Implementasi driver klien yang dipanggil UCX untuk mengonfigurasi titik akhir di pengontrol. |
| EVT_UCX_USBDEVICE_GET_CHARACTERISTIC UCX memanggil panggilan balik ini untuk mengambil karakteristik perangkat. |
| EVT_UCX_USBDEVICE_HUB_INFO Implementasi driver klien yang dipanggil UCX untuk mengambil properti hub. |
| EVT_UCX_USBDEVICE_RESET Implementasi driver klien yang dipanggil UCX ketika port tempat perangkat terpasang direset. |
| EVT_UCX_USBDEVICE_RESUME UCX memanggil fungsi panggilan balik ini untuk melanjutkan perangkat dari status ditangguhkan. |
| EVT_UCX_USBDEVICE_SUSPEND UCX memanggil fungsi panggilan balik ini untuk mengirim status penangguhan perangkat. |
| EVT_UCX_USBDEVICE_UPDATE Implementasi driver klien yang dipanggil UCX untuk memperbarui properti perangkat. |
Struktur
| ADDRESS0_OWNERSHIP_ACQUIRE Berisi parameter untuk mengonfigurasi perangkat. |
| UCX_USBDEVICE_CHARACTERISTIC Menyimpan karakteristik perangkat. |
| UCX_USBDEVICE_CHARACTERISTIC_PATH_DELAY Pelajari cara UCX_USBDEVICE_CHARACTERISTIC_PATH_DELAY menyimpan nilai penundaan jalur transfer isochronous. |
| UCX_USBDEVICE_EVENT_CALLBACKS Struktur ini menyediakan daftar fungsi panggilan balik peristiwa perangkat USB UCX. |
| UCXUSBDEVICE_INFO Berisi informasi tentang perangkat USB. Struktur ini diteruskan oleh UCX dalam fungsi panggilan balik peristiwa EVT_UCX_CONTROLLER_USBDEVICE_ADD. |
| USB_DEVICE_PORT_PATH Berisi jalur port perangkat USB. |
| USBDEVICE_ABORTIO Berisi handel untuk hub atau perangkat Universal Serial Bus (USB) untuk membatalkan transfer data. |
| USBDEVICE_ADDRESS Berisi parameter untuk permintaan transisi perangkat yang ditentukan ke status Ditangani. Struktur ini diteruskan oleh UCX dalam parameter permintaan (Parameters.Others.Arg1) dari objek permintaan kerangka kerja dari fungsi panggilan balik EVT_UCX_USBDEVICE_ADDRESS. |
| USBDEVICE_DISABLE Berisi parameter untuk permintaan untuk menonaktifkan perangkat yang ditentukan. Struktur ini diteruskan oleh UCX dalam parameter permintaan (Parameters.Others.Arg1) dari objek permintaan kerangka kerja dari fungsi panggilan balik EVT_UCX_USBDEVICE_DISABLE. |
| USBDEVICE_ENABLE Berisi parameter untuk permintaan untuk mengaktifkan perangkat yang ditentukan. Struktur ini diteruskan oleh UCX dalam parameter permintaan (Parameters.Others.Arg1) dari objek permintaan kerangka kerja dari fungsi panggilan balik EVT_UCX_USBDEVICE_ENABLE. |
| USBDEVICE_ENABLE_FAILURE_FLAGS Bendera yang diatur oleh driver klien dalam fungsi panggilan balik EVT_UCX_USBDEVICE_ENABLE. Menunjukkan kesalahan, jika ada, yang mungkin telah terjadi saat mengaktifkan perangkat. |
| USBDEVICE_HUB_INFO Berisi parameter untuk permintaan guna mendapatkan informasi tentang hub yang ditentukan. Struktur ini diteruskan oleh UCX dalam parameter permintaan (Parameters.Others.Arg1) dari objek permintaan kerangka kerja dari fungsi panggilan balik EVT_UCX_USBDEVICE_HUB_INFO. |
| USBDEVICE_MGMT_HEADER Struktur ini menyediakan handel untuk hub Universal Serial Bus (USB) atau perangkat yang terhubung secara fisik ke bus. |
| USBDEVICE_PURGEIO Struktur USBDEVICE_PURGEIO berisi handel untuk hub atau perangkat Universal Serial Bus (USB) untuk menghapus menyeluruh I/O. |
| USBDEVICE_RESET Berisi parameter untuk permintaan untuk mengatur ulang perangkat yang ditentukan. Struktur ini diteruskan oleh UCX dalam parameter permintaan (Parameters.Others.Arg1) dari objek permintaan kerangka kerja dari fungsi panggilan balik EVT_UCX_USBDEVICE_RESET. |
| USBDEVICE_STARTIO Berisi handel untuk hub atau perangkat Universal Serial Bus (USB) untuk memulai transfer data. |
| USBDEVICE_TREE_PURGEIO Struktur ini menyediakan handel untuk pohon perangkat Universal Serial Bus (USB) untuk membersihkan I/O. |
| USBDEVICE_UPDATE Diteruskan oleh UCX untuk memperbarui perangkat yang ditentukan. Struktur ini berada dalam parameter permintaan (Parameters.Others.Arg1) dari objek permintaan kerangka kerja yang diteruskan dalam fungsi panggilan balik EVT_UCX_USBDEVICE_UPDATE. |
| USBDEVICE_UPDATE_20_HARDWARE_LPM_PARAMETERS Berisi parameter untuk permintaan untuk memperbarui manajemen daya tautan (LPM) USB 2.0. UCX melewati struktur ini dalam fungsi panggilan balik EVT_UCX_USBDEVICE_UPDATE. |
| USBDEVICE_UPDATE_FAILURE_FLAGS Bendera yang diatur oleh driver klien dalam fungsi panggilan balik EVT_UCX_USBDEVICE_UPDATE. Menunjukkan kesalahan, jika ada, yang mungkin telah terjadi saat memperbarui perangkat. |
| USBDEVICE_UPDATE_FLAGS Berisi bendera permintaan yang ditetapkan oleh UCX yang diteruskan dalam struktur USBDEVICE_UPDATE ketika UCX memanggil fungsi panggilan balik EVT_UCX_USBDEVICE_UPDATE driver klien. |
Enumerasi
| UCX_USBDEVICE_CHARACTERISTIC_TYPE Menentukan nilai yang menunjukkan jenis karakteristik perangkat. |
| UCX_USBDEVICE_RECOVERY_ACTION Menentukan nilai untuk reset pemicu FLDR dan PLDR. |
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk