Fungsi WdfUsbInterfaceGetEndpointInformation (wdfusb.h)

  • Artikel

[Berlaku untuk KMDF dan UMDF]

Metode WdfUsbInterfaceGetEndpointInformation mengambil informasi tentang titik akhir perangkat USB tertentu dan pipa terkait.

Sintaks

void WdfUsbInterfaceGetEndpointInformation(
  [in]      WDFUSBINTERFACE           UsbInterface,
  [in]      UCHAR                     SettingIndex,
  [in]      UCHAR                     EndpointIndex,
  [in, out] PWDF_USB_PIPE_INFORMATION EndpointInfo
);

Parameter

[in] UsbInterface

Handel ke objek antarmuka USB yang diperoleh dengan memanggil WdfUsbTargetDeviceGetInterface.

[in] SettingIndex

Nilai indeks yang mengidentifikasi pengaturan alternatif untuk antarmuka. Untuk informasi selengkapnya tentang pengaturan alternatif, lihat spesifikasi USB.

[in] EndpointIndex

Nilai indeks yang mengidentifikasi titik akhir yang terkait dengan pengaturan alternatif yang ditentukan dari antarmuka yang ditentukan. (Nilai indeks ini bukan alamat titik akhir.)

[in, out] EndpointInfo

Penunjuk ke struktur WDF_USB_PIPE_INFORMATION yang dialokasikan penelepon yang diisi kerangka kerja.

Nilai kembali

Tidak ada

Keterangan

Pemeriksaan bug terjadi jika driver menyediakan handel objek yang tidak valid.

Untuk informasi selengkapnya tentang metode WdfUsbInterfaceGetEndpointInformation dan target I/O USB, lihat Target I/O USB.

Contoh

Contoh kode berikut mendapatkan jumlah titik akhir yang didukung antarmuka USB lalu memanggil WdfUsbInterfaceGetEndpointInformation untuk setiap titik akhir.

WDF_USB_PIPE_INFORMATION endPointInfo;
BYTE settingIndex, i;

settingIndex = 0;
numEndpoints = WdfUsbInterfaceGetNumEndpoints(
                                          UsbInterface,
                                          settingIndex
                                          );

for (i = 0; i < numEndpoints; i++){
    WDF_USB_PIPE_INFORMATION_INIT(&endPointInfo);
    WdfUsbInterfaceGetEndpointInformation(
                                          UsbInterface,
                                          settingIndex,
                                          i,
                                          &endPointInfo
                                          );

    //
    // Examine endpoint information here.
    //
...
}

Persyaratan

Persyaratan Nilai
Target Platform Universal
Versi KMDF minimum 1,0
Versi UMDF minimum 2.0
Header wdfusb.h (termasuk Wdfusb.h)
Pustaka Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL <=DISPATCH_LEVEL
Aturan kepatuhan DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), UsbKmdfIrql(kmdf), UsbKmdfIrql2(kmdf), UsbKmdfIrqlExplicit(kmdf)

Lihat juga

WDF_USB_PIPE_INFORMATION

WdfUsbInterfaceGetNumEndpoints

WdfUsbTargetDeviceGetInterface