WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_URB 함수(wdfusb.h)

아티클
02/29/2024

[KMDF 및 UMDF에 적용]

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

구문

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

매개 변수

[out] Params

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

[in] Urb

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

반환 값

없음

설명

WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_URB 함수는 WDF_USB_INTERFACE_SELECT_SETTING_PARAMS 구조체를 0으로 설정하고 Size 멤버를 구조체의 크기로 설정합니다. 또한 Type 멤버를 WdfUsbInterfaceSelectSettingTypeUrb 로 설정하고 Types.Urb.Urb 멤버를 Urb 포인터로 지정된 값으로 설정합니다.

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

예제

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