struktur WDF_USB_PIPE_INFORMATION (wdfusb.h)

Artikel
08/08/2023

[Berlaku untuk KMDF dan UMDF]

Struktur WDF_USB_PIPE_INFORMATION berisi informasi tentang pipa USB dan titik akhirnya.

Sintaks

typedef struct _WDF_USB_PIPE_INFORMATION {
  ULONG             Size;
  ULONG             MaximumPacketSize;
  UCHAR             EndpointAddress;
  UCHAR             Interval;
  UCHAR             SettingIndex;
  WDF_USB_PIPE_TYPE PipeType;
  ULONG             MaximumTransferSize;
} WDF_USB_PIPE_INFORMATION, *PWDF_USB_PIPE_INFORMATION;

Anggota

Size

Ukuran, dalam byte, dari struktur ini.

MaximumPacketSize

Ukuran paket maksimum, dalam byte, yang mampu dikirim atau diterima oleh titik akhir pipa.

Untuk titik akhir isochronous berkecepatan tinggi, nilai MaximumPacketSize yang diterima mencakup jumlah byte yang dapat ditransfer dalam transaksi tambahan, jika titik akhir mendukungnya.

EndpointAddress

Alamat titik akhir pada perangkat USB. Untuk informasi selengkapnya tentang alamat titik akhir, lihat spesifikasi USB.

Interval

Interval polling titik akhir, jika anggota PipeType diatur ke WdfUsbPipeTypeInterrupt. Untuk informasi selengkapnya tentang interval polling, lihat spesifikasi USB.

SettingIndex

Nilai indeks yang mengidentifikasi pengaturan alternatif, dalam antarmuka, tempat pipa berada. Untuk informasi selengkapnya tentang pengaturan alternatif, lihat spesifikasi USB.

PipeType

Nilai WDF_USB_PIPE_TYPE-typed yang menentukan jenis pipa.

MaximumTransferSize

Anggota ini tidak digunakan.

Keterangan

Struktur WDF_USB_PIPE_INFORMATION diisi oleh metode WdfUsbTargetPipeGetInformation, WdfUsbInterfaceGetConfiguredPipe, dan WdfUsbInterfaceGetEndpointInformation .

Untuk menginisialisasi struktur WDF_USB_PIPE_INFORMATION , driver Anda harus memanggil WDF_USB_PIPE_INFORMATION_INIT.

Untuk informasi selengkapnya tentang anggota MaximumPacketSize dari struktur ini, lihat bagian Keterangan di USBD_PIPE_INFORMATION.

Untuk informasi tentang cara mentransfer data ke dan dari titik akhir isochronous yang didukung di perangkat USB, lihat Cara Mentransfer Data ke Titik Akhir USB Isochronous.