funzione WDF_USB_CONTROL_SETUP_PACKET_INIT_GET_STATUS (wdfusb.h)

Articolo
08/08/2023

[Si applica a KMDF e UMDF]

La funzione WDF_USB_CONTROL_SETUP_PACKET_INIT_GET_STATUS inizializza una struttura WDF_USB_CONTROL_SETUP_PACKET per un trasferimento di controllo USB che ottiene lo stato del dispositivo.

Sintassi

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

Parametri

[out] Packet

Puntatore a una struttura WDF_USB_CONTROL_SETUP_PACKET .

[in] BmRequestRecipient

Valore WDF_USB_BMREQUEST_RECIPIENT tipizzato archiviato nel membro Packet.bm.Request.Recipient della struttura WDF_USB_CONTROL_SETUP_PACKET .

[in] Index

Valore dell'indice di stato archiviato nel membro Packet.wIndex.Value della struttura WDF_USB_CONTROL_SETUP_PACKET .

Valore restituito

nessuno

Osservazioni

La funzione WDF_USB_CONTROL_SETUP_PACKET_INIT_GET_STATUS esegue le operazioni seguenti:

Zeri la struttura WDF_USB_CONTROL_SETUP_PACKET .
Imposta il membro Packet.bm.Request.Type su BmRequestStandard.
Imposta il membro Packet.bm.Request.Dir su BmRequestDeviceToHost.
Imposta il membro Packet.bRequest su un valore di richiesta "get status".
Imposta il membro Packet.wValue.Value su zero.
Imposta il membro Packet->Packet.wIndex.Value sull'argomento Index .

Per inizializzare una struttura WDF_USB_CONTROL_SETUP_PACKET , il driver deve chiamare una delle funzioni seguenti:

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

Esempio

Nell'esempio di codice seguente viene inizializzata una struttura WDF_USB_CONTROL_SETUP_PACKET .

WDF_USB_CONTROL_SETUP_PACKET  packet;

WDF_USB_CONTROL_SETUP_PACKET_INIT_GET_STATUS(
                                             &packet,
                                             BmRequestToDevice,
                                             0
                                             );