struktur WDF_USB_REQUEST_COMPLETION_PARAMS (wdfusb.h)

Artikel
08/08/2023

[Berlaku untuk KMDF dan UMDF]

Struktur WDF_USB_REQUEST_COMPLETION_PARAMS berisi parameter yang terkait dengan penyelesaian permintaan I/O untuk perangkat USB.

Sintaks

typedef struct _WDF_USB_REQUEST_COMPLETION_PARAMS {
  USBD_STATUS          UsbdStatus;
  WDF_USB_REQUEST_TYPE Type;
  union {
    struct {
      WDFMEMORY Buffer;
      USHORT    LangID;
      UCHAR     StringIndex;
      UCHAR     RequiredSize;
    } DeviceString;
    struct {
      WDFMEMORY                    Buffer;
      WDF_USB_CONTROL_SETUP_PACKET SetupPacket;
      ULONG                        Length;
    } DeviceControlTransfer;
    struct {
      WDFMEMORY Buffer;
    } DeviceUrb;
    struct {
      WDFMEMORY Buffer;
      size_t    Length;
      size_t    Offset;
    } PipeWrite;
    struct {
      WDFMEMORY Buffer;
      size_t    Length;
      size_t    Offset;
    } PipeRead;
    struct {
      WDFMEMORY Buffer;
    } PipeUrb;
  } Parameters;
} WDF_USB_REQUEST_COMPLETION_PARAMS, *PWDF_USB_REQUEST_COMPLETION_PARAMS;

Anggota

UsbdStatus

Nilai status jenis USBD_STATUS yang dikembalikan target I/O.

Type

Nilai WDF_USB_REQUEST_TYPE-ketik yang mengidentifikasi jenis permintaan.

Parameters

Parameters.DeviceString

Parameters.DeviceString.Buffer

Jika driver telah memanggil WdfUsbTargetDeviceFormatRequestForString, anggota ini berisi handel yang disediakan driver ke objek memori yang menerima string Unicode.

Parameters.DeviceString.LangID

Jika driver telah memanggil WdfUsbTargetDeviceFormatRequestForString, anggota ini berisi pengidentifikasi bahasa yang disediakan driver.

Parameters.DeviceString.StringIndex

Jika driver telah memanggil WdfUsbTargetDeviceFormatRequestForString, anggota ini berisi indeks string yang disediakan driver.

Parameters.DeviceString.RequiredSize

Jika driver telah memanggil metode apa pun yang mendapatkan string Unicode perangkat (kecuali WdfUsbTargetDeviceFormatRequestForUrb), anggota ini berisi ukuran buffer yang diperlukan yang ditentukan Parameters.DeviceString.Buffer .

Jika driver yang disebut WdfUsbTargetDeviceFormatRequestForUrb, driver dapat memperoleh nilai ukuran yang diperlukan dari URB yang handelnya ada di Parameters.DeviceUrb.Buffer.

Parameters.DeviceControlTransfer

Parameters.DeviceControlTransfer.Buffer

Jika driver telah memanggil WdfUsbTargetDeviceFormatRequestForControlTransfer, anggota ini berisi handel yang disediakan driver ke objek memori yang menerima data input atau output.

Parameters.DeviceControlTransfer.SetupPacket

Jika driver telah memanggil WdfUsbTargetDeviceFormatRequestForControlTransfer, anggota ini berisi alamat struktur WDF_USB_CONTROL_SETUP_PACKET yang disediakan driver.

Parameters.DeviceControlTransfer.Length

Jika driver telah memanggil metode apa pun yang mengirim transfer kontrol (kecuali WdfUsbTargetDeviceFormatRequestForUrb), anggota ini berisi jumlah byte yang dikirim atau diterima.

Jika driver bernama WdfUsbTargetDeviceFormatRequestForUrb, driver dapat memperoleh nilai panjang dari URB yang handelnya ada di Parameters.DeviceUrb.Buffer.

Parameters.DeviceUrb

Parameters.DeviceUrb.Buffer

Jika driver telah memanggil WdfUsbTargetDeviceFormatRequestForUrb, anggota ini berisi handel yang disediakan driver ke objek memori yang berisi struktur URB .

Parameters.PipeWrite

Parameters.PipeWrite.Buffer

Jika driver telah memanggil WdfUsbTargetPipeFormatRequestForWrite, anggota ini berisi handel yang disediakan driver ke objek memori yang ditulis ke pipa.

Parameters.PipeWrite.Length

Jika driver telah memanggil metode apa pun yang menulis ke pipa (kecuali WdfUsbTargetDeviceFormatRequestForUrb), anggota ini berisi jumlah byte yang dikirim.

Jika driver yang disebut WdfUsbTargetDeviceFormatRequestForUrb, driver dapat memperoleh nilai panjang dari URB yang handelnya ada di Parameters.PipeUrb.Buffer.

Parameters.PipeWrite.Offset

Jika driver telah memanggil WdfUsbTargetPipeFormatRequestForWrite, anggota ini berisi offset buffer yang disediakan driver.

Parameters.PipeRead

Parameters.PipeRead.Buffer

Jika driver telah memanggil WdfUsbTargetPipeFormatRequestForRead, anggota ini berisi handel yang disediakan driver ke objek memori yang berisi data yang dibaca dari pipa.

Parameters.PipeRead.Length

Jika driver telah memanggil metode apa pun yang berbunyi dari pipa mengirimkan transfer kontrol (kecuali WdfUsbTargetDeviceFormatRequestForUrb), anggota ini berisi jumlah byte yang diterima.

Jika driver yang disebut WdfUsbTargetDeviceFormatRequestForUrb, driver dapat memperoleh nilai panjang dari URB yang handelnya ada di Parameters.PipeUrb.Buffer.

Parameters.PipeRead.Offset

Jika driver telah memanggil WdfUsbTargetPipeFormatRequestForRead, anggota ini berisi offset buffer yang disediakan driver.

Parameters.PipeUrb

Parameters.PipeUrb.Buffer

Jika driver telah memanggil WdfUsbTargetPipeFormatRequestForUrb, anggota ini berisi handel yang disediakan driver ke objek memori yang berisi struktur URB .