WDF_USB_REQUEST_COMPLETION_PARAMS Struktur (wdfusb.h)

Artikel
02/07/2025

[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;

Angehörige

UsbdStatus

Der USBD_STATUS-typed-Statuswert, den das E/A-Ziel zurückgegeben hat.

Type

Ein WDF_USB_REQUEST_TYPE-typed-Werte, die den Anforderungstyp identifizieren.

Parameters

Parameters.DeviceString

Parameters.DeviceString.Buffer

Wenn der Treiber WdfUsbTargetDeviceFormatRequestForStringaufgerufen 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 WdfUsbTargetDeviceFormatRequestForStringaufgerufen hat, enthält dieses Element den vom Treiber bereitgestellten Sprachbezeichner.

Parameters.DeviceString.StringIndex

Wenn der Treiber WdfUsbTargetDeviceFormatRequestForStringaufgerufen 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 (außer WdfUsbTargetDeviceFormatRequestForUrb), enthält dieses Element die erforderliche Größe des Puffers, der Parameters.DeviceString.Buffer angibt.

Wenn der Treiber WdfUsbTargetDeviceFormatRequestForUrbaufgerufen wird, kann er den erforderlichen Größenwert aus dem URB abrufen, dessen Handle sich in Parameters.DeviceUrb.Bufferbefindet.

Parameters.DeviceControlTransfer

Parameters.DeviceControlTransfer.Buffer

Wenn der Treiber WdfUsbTargetDeviceFormatRequestForControlTransferaufgerufen 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 WdfUsbTargetDeviceFormatRequestForControlTransferaufgerufen 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 Steuerungsübertragung sendet (mit Ausnahme von WdfUsbTargetDeviceFormatRequestForUrb), enthält dieses Element die Anzahl der gesendeten oder empfangenen Bytes.

Wenn der Treiber WdfUsbTargetDeviceFormatRequestForUrbaufgerufen wird, kann er den Längenwert aus dem URB abrufen, dessen Handle sich in Parameters.DeviceUrb.Bufferbefindet.

Parameters.DeviceUrb

Parameters.DeviceUrb.Buffer

Wenn der Treiber WdfUsbTargetDeviceFormatRequestForUrbaufgerufen 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 WdfUsbTargetPipeFormatRequestForWriteaufgerufen 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 Methode aufgerufen hat, die in eine Pipe- schreibt (außer WdfUsbTargetDeviceFormatRequestForUrb), enthält dieses Element die Anzahl der gesendeten Bytes.

Wenn der Treiber WdfUsbTargetDeviceFormatRequestForUrbaufgerufen wird, kann er den Längenwert aus dem URB abrufen, dessen Handle sich in Parameters.PipeUrb.Bufferbefindet.

Parameters.PipeWrite.Offset

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

Parameters.PipeRead

Parameters.PipeRead.Buffer

Wenn der Treiber WdfUsbTargetPipeFormatRequestForReadaufgerufen 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 Methode aufgerufen hat, die von einer Pipe gelesen eine Steuerungsübertragung sendet (mit Ausnahme WdfUsbTargetDeviceFormatRequestForUrb), enthält dieses Element die Anzahl der empfangenen Bytes.

Wenn der Treiber WdfUsbTargetDeviceFormatRequestForUrbaufgerufen wird, kann er den Längenwert aus dem URB abrufen, dessen Handle sich in Parameters.PipeUrb.Bufferbefindet.

Parameters.PipeRead.Offset

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

Parameters.PipeUrb

Parameters.PipeUrb.Buffer

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