Bekerja dengan Antarmuka USB

  • Artikel

Kerangka kerja mewakili setiap antarmuka USB sebagai objek antarmuka USB kerangka kerja. Ketika driver membuat objek perangkat USB kerangka kerja, kerangka kerja membuat objek antarmuka USB kerangka kerja untuk setiap antarmuka USB yang dikandung konfigurasi USB pertama perangkat.

Sebagian besar perangkat USB hanya memiliki satu antarmuka, dan antarmuka hanya memiliki satu pengaturan alternatif. Driver untuk perangkat tersebut biasanya tidak perlu menggunakan metode objek yang ditentukan objek antarmuka USB kerangka kerja.

Jika driver Anda mendukung perangkat USB yang menyediakan beberapa antarmuka atau pengaturan alternatif, metode objek antarmuka memungkinkan driver untuk melakukan operasi berikut:

Mendapatkan Informasi Antarmuka

Setelah driver Anda memanggil WdfUsbTargetDeviceCreateWithParameters, driver dapat memanggil WdfUsbTargetDeviceGetInterface untuk mendapatkan handel ke objek antarmuka USB kerangka kerja yang mewakili salah satu antarmuka USB perangkat. Kemudian driver Anda dapat memanggil beberapa metode yang ditentukan objek antarmuka USB untuk mendapatkan informasi tentang antarmuka USB.

Driver Anda dapat memanggil metode berikut kapan saja setelah disebut WdfUsbTargetDeviceCreateWithParameters:

WdfUsbInterfaceGetInterfaceNumber
Mengembalikan nomor antarmuka USB yang terkait dengan objek antarmuka USB.

WdfUsbInterfaceGetDescriptor
Mengambil deskriptor antarmuka USB yang terkait dengan salah satu pengaturan alternatif antarmuka USB.

WdfUsbInterfaceGetNumEndpoints
Mengembalikan jumlah titik akhir yang terkait dengan salah satu pengaturan alternatif antarmuka USB.

WdfUsbInterfaceGetEndpointInformation
Mengambil informasi tentang titik akhir dan pipa terkait.

Driver Anda dapat memanggil metode berikut setelah disebut WdfUsbTargetDeviceSelectConfig:

WdfUsbInterfaceGetConfiguredSettingIndex
Mengembalikan nilai indeks yang mengidentifikasi pengaturan alternatif yang saat ini dipilih untuk antarmuka USB.

WdfUsbInterfaceGetNumConfiguredPipes
Mengembalikan jumlah pipa yang dikonfigurasi untuk antarmuka perangkat USB tertentu.

WdfUsbInterfaceGetConfiguredPipe
Mengembalikan handel ke objek pipa kerangka kerja yang terkait dengan antarmuka perangkat USB dan indeks pipa tertentu.

Memilih Pengaturan Alternatif untuk Antarmuka USB

Setelah driver memanggil WdfUsbTargetDeviceCreateWithParameters, driver dapat memanggil WdfUsbInterfaceGetNumSettings untuk mendapatkan jumlah pengaturan alternatif yang didukung antarmuka USB.

Setelah driver memanggil WdfUsbTargetDeviceSelectConfig untuk memilih konfigurasi untuk perangkat USB, driver dapat memanggil WdfUsbInterfaceSelectSetting untuk memilih pengaturan alternatif untuk salah satu antarmuka USB konfigurasi.

Pengaturan alternatif perangkat harus dinomori secara bersebelahan, dimulai dengan nol.

Untuk informasi terkait, lihat Cara memilih pengaturan alternatif di antarmuka USB.