WDF_USB_REQUEST_COMPLETION_PARAMS-Struktur (wdfusb.h)

Artikel
02/27/2024

[Gilt für KMDF und UMDF]

Die WDF_USB_REQUEST_COMPLETION_PARAMS-Struktur enthält Parameter, die dem Abschluss einer E/A-Anforderung für ein USB-Gerät zugeordnet sind.

Syntax

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;

Member

UsbdStatus

Der USBD_STATUS typisierte status Wert, den das E/A-Ziel zurückgegeben hat.

Type

Ein WDF_USB_REQUEST_TYPE typisierte Werte, der den Anforderungstyp identifiziert.

Parameters

Parameters.DeviceString

Parameters.DeviceString.Buffer

Wenn der Treiber WdfUsbTargetDeviceFormatRequestForString aufgerufen hat, enthält dieses Element das vom Treiber bereitgestellte Handle für das Speicherobjekt, das die Unicode-Zeichenfolge empfängt.

Parameters.DeviceString.LangID

Wenn der Treiber WdfUsbTargetDeviceFormatRequestForString aufgerufen hat, enthält dieses Element den vom Treiber bereitgestellten Sprachbezeichner.

Parameters.DeviceString.StringIndex

Wenn der Treiber WdfUsbTargetDeviceFormatRequestForString aufgerufen hat, enthält dieses Element den vom Treiber bereitgestellten Zeichenfolgenindex.

Parameters.DeviceString.RequiredSize

Wenn der Treiber eine Methode aufgerufen hat, die die Unicode-Zeichenfolgen eines Geräts abruft (mit Ausnahme von WdfUsbTargetDeviceFormatRequestForUrb), enthält dieses Element die erforderliche Größe des Puffers, den Parameters.DeviceString.Buffer angibt.

Wenn der Treiber WdfUsbTargetDeviceFormatRequestForUrb heißt, kann er den erforderlichen Größenwert aus der URB abrufen, deren Handle in Parameters.DeviceUrb.Buffer ist.

Parameters.DeviceControlTransfer

Parameters.DeviceControlTransfer.Buffer

Wenn der Treiber WdfUsbTargetDeviceFormatRequestForControlTransfer aufgerufen hat, enthält dieses Element das vom Treiber bereitgestellte Handle für das Speicherobjekt, das Eingabe- oder Ausgabedaten empfängt.

Parameters.DeviceControlTransfer.SetupPacket

Wenn der Treiber WdfUsbTargetDeviceFormatRequestForControlTransfer aufgerufen hat, enthält dieses Element die Adresse der WDF_USB_CONTROL_SETUP_PACKET Struktur, die der Treiber bereitgestellt hat.

Parameters.DeviceControlTransfer.Length

Wenn der Treiber eine Methode aufgerufen hat, die eine Steuerelementübertragung sendet (außer WdfUsbTargetDeviceFormatRequestForUrb), enthält dieses Element die Anzahl der gesendeten oder empfangenen Bytes.

Wenn der Treiber WdfUsbTargetDeviceFormatRequestForUrb heißt, kann er den Längenwert von der URB abrufen, deren Handle in Parameters.DeviceUrb.Buffer ist.

Parameters.DeviceUrb

Parameters.DeviceUrb.Buffer

Wenn der Treiber WdfUsbTargetDeviceFormatRequestForUrb aufgerufen hat, enthält dieses Element das vom Treiber bereitgestellte Handle für das Speicherobjekt, das eine URB-Struktur enthält.

Parameters.PipeWrite

Parameters.PipeWrite.Buffer

Wenn der Treiber WdfUsbTargetPipeFormatRequestForWrite aufgerufen hat, enthält dieses Element das vom Treiber bereitgestellte Handle für das Speicherobjekt, das in die Pipe geschrieben wurde.

Parameters.PipeWrite.Length

Wenn der Treiber eine Beliebige Methode aufgerufen hat , die in eine Pipe schreibt (mit Ausnahme von WdfUsbTargetDeviceFormatRequestForUrb), enthält dieses Element die Anzahl der gesendeten Bytes.

Wenn der Treiber WdfUsbTargetDeviceFormatRequestForUrb heißt, kann er den Längenwert aus der URB abrufen, deren Handle in Parameters.PipeUrb.Buffer ist.

Parameters.PipeWrite.Offset

Wenn der Treiber WdfUsbTargetPipeFormatRequestForWrite aufgerufen hat, enthält dieses Element den vom Treiber bereitgestellten Pufferoffset.

Parameters.PipeRead

Parameters.PipeRead.Buffer

Wenn der Treiber WdfUsbTargetPipeFormatRequestForRead aufgerufen hat, enthält dieses Element das vom Treiber bereitgestellte Handle für das Speicherobjekt, das Daten enthält, die aus der Pipe gelesen wurden.

Parameters.PipeRead.Length

Wenn der Treiber eine Beliebige Methode aufgerufen hat, die aus einer Pipe liest , die eine Steuerelementübertragung sendet (mit Ausnahme von WdfUsbTargetDeviceFormatRequestForUrb), enthält dieses Element die Anzahl der empfangenen Bytes.

Wenn der Treiber WdfUsbTargetDeviceFormatRequestForUrb heißt, kann er den Längenwert aus der URB abrufen, deren Handle in Parameters.PipeUrb.Buffer ist.

Parameters.PipeRead.Offset

Wenn der Treiber WdfUsbTargetPipeFormatRequestForRead aufgerufen hat, enthält dieses Element den vom Treiber bereitgestellten Pufferoffset.

Parameters.PipeUrb

Parameters.PipeUrb.Buffer

Wenn der Treiber WdfUsbTargetPipeFormatRequestForUrb aufgerufen hat, enthält dieses Element das vom Treiber bereitgestellte Handle für das Speicherobjekt, das eine URB-Struktur enthält.