Partilhar via


função WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_URB (wdfusb.h)

[Aplica-se a KMDF e UMDF]

A função WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_URB inicializa uma estrutura WDF_USB_INTERFACE_SELECT_SETTING_PARAMS para que um driver possa selecionar uma interface USB especificando um URB.

Sintaxe

VOID WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_URB(
  [out] PWDF_USB_INTERFACE_SELECT_SETTING_PARAMS Params,
  [in]  PURB                                     Urb
);

Parâmetros

[out] Params

Um ponteiro para uma estrutura de WDF_USB_INTERFACE_SELECT_SETTING_PARAMS alocada pelo driver.

[in] Urb

Um ponteiro para uma estrutura de URB.

Valor de retorno

Nenhum

Observações

A função WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_URB zera a estrutura WDF_USB_INTERFACE_SELECT_SETTING_PARAMS e define seu membro Size para o tamanho da estrutura. Ele também define o membro tipo como WdfUsbInterfaceSelectSettingTypeUrb e define o membro Types.Urb.Urb para o valor especificado pelo ponteiro Urb.

Para inicializar uma estrutura de WDF_USB_INTERFACE_SELECT_SETTING_PARAMS, o driver deve chamar uma das seguintes funções:

Exemplos

O exemplo de código a seguir inicializa uma estrutura URB e usa a estrutura como entrada para WdfUsbInterfaceSelectSetting.

WDF_USB_INTERFACE_SELECT_SETTING_PARAMS  selectSettingParams;
URB  urb;
NTSTATUS  Status;

//
// Initialize the URB structure here.
//
...

//
// Initialize the WDF_USB_INTERFACE_SELECT_SETTING_PARAMS 
// structure and call WdfUsbInterfaceSelectSetting.
//
WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_URB(
                                      &selectSettingParams,
                                      &urb
                                      );

Status = WdfUsbInterfaceSelectSetting(
                                      UsbInterface,
                                      WDF_NO_OBJECT_ATTRIBUTES,
                                      &selectSettingParams
                                      );

Requisitos

Requisito Valor
da Plataforma de Destino Universal
versão mínima do KMDF 1.0
versão mínima do UMDF 2.0
cabeçalho wdfusb.h (inclua Wdfusb.h)

Consulte também

URB

WDF_USB_INTERFACE_SELECT_SETTING_PARAMS

WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_DESCRIPTOR

WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_SETTING