función WDF_USB_CONTROL_SETUP_PACKET_INIT_GET_STATUS (wdfusb.h)

Artículo
08/08/2023

[Se aplica a KMDF y UMDF]

La función WDF_USB_CONTROL_SETUP_PACKET_INIT_GET_STATUS inicializa una estructura de WDF_USB_CONTROL_SETUP_PACKET para una transferencia de control USB que obtiene el estado del dispositivo.

Sintaxis

void WDF_USB_CONTROL_SETUP_PACKET_INIT_GET_STATUS(
  [out] PWDF_USB_CONTROL_SETUP_PACKET Packet,
  [in]  WDF_USB_BMREQUEST_RECIPIENT   BmRequestRecipient,
  [in]  USHORT                        Index
);

Parámetros

[out] Packet

Puntero a una estructura de WDF_USB_CONTROL_SETUP_PACKET .

[in] BmRequestRecipient

Valor WDF_USB_BMREQUEST_RECIPIENT con tipo que se almacena en el miembro Packet.bm.Request.Recipient de la estructura WDF_USB_CONTROL_SETUP_PACKET .

[in] Index

Valor de índice de estado almacenado en el miembro Packet.wIndex.Value de la estructura WDF_USB_CONTROL_SETUP_PACKET .

Valor devuelto

None

Observaciones

La función WDF_USB_CONTROL_SETUP_PACKET_INIT_GET_STATUS hace lo siguiente:

Cero la estructura WDF_USB_CONTROL_SETUP_PACKET .
Establece el miembro Packet.bm.Request.Type en BmRequestStandard.
Establece el miembro Packet.bm.Request.Dir en BmRequestDeviceToHost.
Establece el miembro Packet.bRequest en un valor de solicitud "get status".
Establece el miembro Packet.wValue.Value en cero.
Establece el miembro Packet->Packet.wIndex.Value en el argumento Index .

Para inicializar una estructura de WDF_USB_CONTROL_SETUP_PACKET , el controlador debe llamar a una de las siguientes funciones:

WDF_USB_CONTROL_SETUP_PACKET_INIT
WDF_USB_CONTROL_SETUP_PACKET_INIT_CLASS
WDF_USB_CONTROL_SETUP_PACKET_INIT_FEATURE
WDF_USB_CONTROL_SETUP_PACKET_INIT_GET_STATUS
WDF_USB_CONTROL_SETUP_PACKET_INIT_VENDOR

Ejemplos

En el ejemplo de código siguiente se inicializa una estructura de WDF_USB_CONTROL_SETUP_PACKET .

WDF_USB_CONTROL_SETUP_PACKET  packet;

WDF_USB_CONTROL_SETUP_PACKET_INIT_GET_STATUS(
                                             &packet,
                                             BmRequestToDevice,
                                             0
                                             );