estructura WDF_REQUEST_COMPLETION_PARAMS (wdfrequest.h)

Artículo
08/08/2023

[Se aplica a KMDF y UMDF]

La estructura WDF_REQUEST_COMPLETION_PARAMS contiene parámetros asociados a la finalización de una solicitud de E/S.

Sintaxis

typedef struct _WDF_REQUEST_COMPLETION_PARAMS {
  ULONG            Size;
  WDF_REQUEST_TYPE Type;
  IO_STATUS_BLOCK  IoStatus;
  union {
    struct {
      WDFMEMORY Buffer;
      size_t    Length;
      size_t    Offset;
    } Write;
    struct {
      WDFMEMORY Buffer;
      size_t    Length;
      size_t    Offset;
    } Read;
    struct {
      ULONG  IoControlCode;
      struct {
        WDFMEMORY Buffer;
        size_t    Offset;
      } Input;
      struct {
        WDFMEMORY Buffer;
        size_t    Offset;
        size_t    Length;
      } Output;
    } Ioctl;
    struct {
      union {
        PVOID     Ptr;
        ULONG_PTR Value;
      } Argument1;
      union {
        PVOID     Ptr;
        ULONG_PTR Value;
      } Argument2;
      union {
        PVOID     Ptr;
        ULONG_PTR Value;
      } Argument3;
      union {
        PVOID     Ptr;
        ULONG_PTR Value;
      } Argument4;
    } Others;
    struct {
      PWDF_USB_REQUEST_COMPLETION_PARAMS Completion;
    } Usb;
  } Parameters;
} WDF_REQUEST_COMPLETION_PARAMS, *PWDF_REQUEST_COMPLETION_PARAMS;

Miembros

Size

Tamaño, en bytes, de esta estructura.

Type

Valor WDF_REQUEST_TYPE que identifica el tipo de solicitud.

IoStatus

Estructura IO_STATUS_BLOCK de la solicitud.

Parameters

Valores específicos de la solicitud.

Parameters.Write

Parameters.Write.Buffer

Identificador de un objeto de memoria de marco. Este objeto identifica el búfer que el controlador especificó al dar formato a la solicitud y lo envió a un destino de E/S.

Parameters.Write.Length

Longitud, en bytes, de la transferencia.

Parameters.Write.Offset

Dirección inicial dentro del búfer para la transferencia de datos.

Parameters.Read

Parameters.Read.Buffer

Identificador de un objeto de memoria de marco. Este objeto identifica el búfer que el controlador especificó al dar formato a la solicitud y lo envió a un destino de E/S.

Parameters.Read.Length

Longitud, en bytes, de la transferencia.

Parameters.Read.Offset

Dirección inicial dentro del búfer para la transferencia de datos.

Parameters.Ioctl

Parameters.Ioctl.IoControlCode

Parameters.Ioctl.Input

Parameters.Ioctl.Input.Buffer

Identificador de un objeto de memoria de marco. Este objeto identifica el búfer de entrada que el controlador especificó al dar formato a la solicitud y lo envió a un destino de E/S.

Parameters.Ioctl.Input.Offset

Dirección inicial dentro del búfer para la transferencia de datos.

Parameters.Ioctl.Output

Parameters.Ioctl.Output.Buffer

Identificador de un objeto de memoria de marco. Este objeto identifica los búferes de salida que el controlador especificó al dar formato a la solicitud y lo envió a un destino de E/S.

Parameters.Ioctl.Output.Offset

Dirección inicial dentro del búfer para la transferencia de datos.

Parameters.Ioctl.Output.Length

Longitud, en bytes, de la transferencia.

Parameters.Others

Parameters.Others.Argument1

El uso de este miembro se define mediante la pila de controladores. Vea la sección Comentarios.

Parameters.Others.Argument1.Ptr

Parameters.Others.Argument1.Value

Parameters.Others.Argument2

El uso de este miembro se define mediante la pila de controladores.

Parameters.Others.Argument2.Ptr

Parameters.Others.Argument2.Value

Parameters.Others.Argument3

El uso de este miembro se define mediante la pila de controladores.

Parameters.Others.Argument3.Ptr

Parameters.Others.Argument3.Value

Parameters.Others.Argument4

El uso de este miembro se define mediante la pila de controladores.

Parameters.Others.Argument4.Ptr

Parameters.Others.Argument4.Value

Parameters.Usb

En el caso de los dispositivos USB, este miembro contiene un puntero a una estructura WDF_USB_REQUEST_COMPLETION_PARAMS .

Parameters.Usb.Completion

Comentarios

La estructura WDF_REQUEST_COMPLETION_PARAMS se usa como entrada para el método WdfRequestGetCompletionParams y la función de devolución de llamada CompletionRoutine de un controlador.

En ambos casos, la estructura de parámetros de finalización contiene información válida solo si el controlador ha dado formato a la solicitud llamando a uno de los métodos WdfIoTargetFormatXxx . Por ejemplo, vea WdfIoTargetFormatRequestForRead.

Antes de llamar a WdfRequestGetCompletionParams para recuperar la información de finalización de E/S de una solicitud, el controlador debe llamar primero a WDF_REQUEST_COMPLETION_PARAMS_INIT para inicializar la estructura de WDF_REQUEST_COMPLETION_PARAMS .

Los miembros Parameters.Others.Argument son argumentos personalizados que un controlador suele pasar por la pila (y puede volver después de completar la solicitud). Se usan para datos dependientes de la pila de controladores no estándar. Por ejemplo, un controlador USB especifica un puntero a un URB en Parameters.Others.Argument1 cuando envía una solicitud de IOCTL_INTERNAL_USB_SUBMIT_URB a la pila USB. Del mismo modo, un controlador Bluetooth especifica un puntero a un BRB (bloque de solicitud Bluetooth) en Parameters.Others.Argument1 cuando recibe un IOCTL_INTERNAL_BTH_SUBMIT_BRB.