función WDF_USB_CONTROL_SETUP_PACKET_INIT_GET_STATUS (wdfusb.h)

Artículo
02/07/2025

[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 WDF_USB_CONTROL_SETUP_PACKET.

[in] BmRequestRecipient

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

[in] Index

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

Valor devuelto

Ninguno

Observaciones

La función WDF_USB_CONTROL_SETUP_PACKET_INIT_GET_STATUS hace lo siguiente:

Ceros la estructura WDF_USB_CONTROL_SETUP_PACKET.
Establece el Packet.bm.Request.Type en bmRequestStandard.
Establece el Packet.bm.Request.Dir en BmRequestDeviceToHost.
Establece el Packet.bRequest miembro 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 funciones siguientes:

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 WDF_USB_CONTROL_SETUP_PACKET.

WDF_USB_CONTROL_SETUP_PACKET  packet;

WDF_USB_CONTROL_SETUP_PACKET_INIT_GET_STATUS(
                                             &packet,
                                             BmRequestToDevice,
                                             0
                                             );