função WDF_USB_CONTROL_SETUP_PACKET_INIT_FEATURE (wdfusb.h)

[Aplica-se a KMDF e UMDF]

A função WDF_USB_CONTROL_SETUP_PACKET_INIT_FEATURE inicializa uma estrutura de WDF_USB_CONTROL_SETUP_PACKET para uma transferência de controle USB que define ou limpa um recurso de dispositivo.

Sintaxe

VOID WDF_USB_CONTROL_SETUP_PACKET_INIT_FEATURE(
  [out] PWDF_USB_CONTROL_SETUP_PACKET Packet,
  [in]  WDF_USB_BMREQUEST_RECIPIENT   BmRequestRecipient,
  [in]  USHORT                        FeatureSelector,
  [in]  USHORT                        Index,
  [in]  BOOLEAN                       SetFeature
);

Parâmetros

[out] Packet

Um ponteiro para uma estrutura de WDF_USB_CONTROL_SETUP_PACKET.

[in] BmRequestRecipient

Um valor WDF_USB_BMREQUEST_RECIPIENTdigitado que é armazenado no membro Packet.bm.Request.Recipient da estrutura WDF_USB_CONTROL_SETUP_PACKET.

[in] FeatureSelector

Um valor específico do recurso armazenado no packet.wValue.Value membro da estrutura WDF_USB_CONTROL_SETUP_PACKET.

[in] Index

Um valor de índice específico do recurso armazenado no packet.wIndex.Value membro da estrutura WDF_USB_CONTROL_SETUP_PACKET.

[in] SetFeature

Um valor booliano que, se VERDADEIRO, indica que o recurso especificado será definido. Se FALSE, o recurso especificado será limpo.

Valor de retorno

Nenhum

Observações

A função WDF_USB_CONTROL_SETUP_PACKET_INIT_FEATURE faz o seguinte:

1. Zera a estrutura WDF_USB_CONTROL_SETUP_PACKET.
2. Define o membro Packet.bm.Request.Type como BmRequestStandard.
3. Define o membro Packet.bm.Request.Dir como BmRequestDeviceToDevice.
4. Define o membro Packet.bRequest como um valor de solicitação "set feature" ou "clear feature", com base no argumento SetFeature.
5. Define outros membros da estrutura usando os argumentos de entrada da função WDF_USB_CONTROL_SETUP_PACKET_INIT_FEATURE.

• 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

Exemplos

O exemplo de código a seguir inicializa uma estrutura de WDF_USB_CONTROL_SETUP_PACKET.

WDF_USB_CONTROL_SETUP_PACKET packet;

WDF_USB_CONTROL_SETUP_PACKET_INIT_FEATURE(
                                          &packet,
                                          BMREQUEST_TO_DEVICE,
                                          USB_DEVICE_DESCRIPTOR_TYPE,
                                          0,
                                          FALSE
                                          );

Requisitos

Consulte também

WDF_USB_BMREQUEST_RECIPIENT

WDF_USB_CONTROL_SETUP_PACKET

WDF_USB_CONTROL_SETUP_PACKET_INIT

WDF_USB_CONTROL_SETUP_PACKET_INIT_CLASS

WDF_USB_CONTROL_SETUP_PACKET_INIT_GET_STATUS

WDF_USB_CONTROL_SETUP_PACKET_INIT_VENDOR