WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_DESCRIPTOR 함수(wdfusb.h)

아티클
08/08/2023

[KMDF 및 UMDF에 적용]

WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_DESCRIPTOR 함수는 드라이버가 인터페이스 설명자를 지정하여 USB 인터페이스를 선택할 수 있도록 WDF_USB_INTERFACE_SELECT_SETTING_PARAMS 구조를 초기화합니다.

구문

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

매개 변수

[out] Params

드라이버 할당 WDF_USB_INTERFACE_SELECT_SETTING_PARAMS 구조체에 대한 포인터입니다.

[in] Interface

USB_INTERFACE_DESCRIPTOR 구조체에 대한 포인터입니다.

반환 값

없음

설명

WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_DESCRIPTOR 함수는 WDF_USB_INTERFACE_SELECT_SETTING_PARAMS 구조체를 0으로 설정하고 Size 멤버를 구조체의 크기로 설정합니다. 또한 Type 멤버를 WdfUsbInterfaceSelectSettingTypeDescriptor 로 설정하고 Types.Descriptor.InterfaceDescriptor 멤버를 인터페이스 포인터 값으로 설정합니다.

WDF_USB_INTERFACE_SELECT_SETTING_PARAMS 구조를 초기화하려면 드라이버가 다음 함수 중 하나를 호출해야 합니다.

WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_DESCRIPTOR
WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_SETTING
WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_URB

예제

다음 코드 예제에서는 USB_INTERFACE_DESCRIPTOR 구조를 초기화한 다음 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
                                      );