função WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_DESCRIPTOR (wdfusb.h)

Artigo
08/08/2023

[Aplica-se a KMDF e UMDF]

A função WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_DESCRIPTOR inicializa uma estrutura WDF_USB_INTERFACE_SELECT_SETTING_PARAMS para que um driver possa selecionar uma interface USB especificando um descritor de interface.

Sintaxe

void WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_DESCRIPTOR(
  [out] PWDF_USB_INTERFACE_SELECT_SETTING_PARAMS Params,
  [in]  PUSB_INTERFACE_DESCRIPTOR                Interface
);

Parâmetros

[out] Params

Um ponteiro para uma estrutura de WDF_USB_INTERFACE_SELECT_SETTING_PARAMS alocada por driver.

[in] Interface

Um ponteiro para uma estrutura USB_INTERFACE_DESCRIPTOR .

Retornar valor

Nenhum

Comentários

A função WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_DESCRIPTOR zeros a estrutura WDF_USB_INTERFACE_SELECT_SETTING_PARAMS e define seu membro Size como o tamanho da estrutura. Ele também define o membro Type como WdfUsbInterfaceSelectSettingTypeDescriptor e define o membro Types.Descriptor.InterfaceDescriptor como o valor do ponteiro Interface .

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

WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_DESCRIPTOR
WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_SETTING
WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_URB

Exemplos

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

WDF_USB_INTERFACE_SELECT_SETTING_PARAMS  selectSettingParams;
USB_INTERFACE_DESCRIPTOR  interfaceDescriptor;
NTSTATUS  Status;

//
// Initialize the USB_INTERFACE_DESCRIPTOR structure here.
//
...

//
// Initialize the WDF_USB_INTERFACE_SELECT_SETTING_PARAMS 
// structure and call WdfUsbInterfaceSelectSetting.
//
WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_DESCRIPTOR(
                                      &selectSettingParams,
                                      &interfaceDescriptor
                                      );

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