WDF_USB_DEVICE_SELECT_CONFIG_PARAMS 구조체(wdfusb.h)

아티클
02/07/2025

[KMDF 및 UMDF에 적용]

WDF_USB_DEVICE_SELECT_CONFIG_PARAMS 구조는 USB 디바이스 구성 매개 변수를 지정합니다.

통사론

typedef struct _WDF_USB_DEVICE_SELECT_CONFIG_PARAMS {
  ULONG                              Size;
  WdfUsbTargetDeviceSelectConfigType Type;
  union {
    struct {
      PUSB_CONFIGURATION_DESCRIPTOR ConfigurationDescriptor;
      PUSB_INTERFACE_DESCRIPTOR     *InterfaceDescriptors;
      ULONG                         NumInterfaceDescriptors;
    } Descriptor;
    struct {
      PURB Urb;
    } Urb;
    struct {
      UCHAR           NumberConfiguredPipes;
      WDFUSBINTERFACE ConfiguredUsbInterface;
    } SingleInterface;
    struct {
      UCHAR                           NumberInterfaces;
      PWDF_USB_INTERFACE_SETTING_PAIR Pairs;
      UCHAR                           NumberOfConfiguredInterfaces;
    } MultiInterface;
  } Types;
} WDF_USB_DEVICE_SELECT_CONFIG_PARAMS, *PWDF_USB_DEVICE_SELECT_CONFIG_PARAMS;

회원

Size

이 구조체의 크기(바이트)입니다.

Type

선택 중인 구성의 형식을 지정하거나 현재 구성이 구성되고 있음을 나타내는 WdfUsbTargetDeviceSelectConfigType형식화된 값입니다.

Types

Types.Descriptor

Types.Descriptor.ConfigurationDescriptor

드라이버가 Type 멤버를 WdfUsbTargetDeviceSelectConfigTypeInterfacesDescriptor설정하는 경우 이 멤버에는 구성 설명자를 지정하는 USB_CONFIGURATION_DESCRIPTOR 구조체에 대한 드라이버 제공 포인터가 포함됩니다. 이 포인터가 NULL 경우 프레임워크는 디바이스의 첫 번째 구성을 사용합니다. USB 구성을 선택하는 방법에 대한 자세한 내용은 WdfUsbTargetDeviceSelectConfig설명 섹션을 참조하세요.

Types.Descriptor.InterfaceDescriptors

드라이버가 TypeWdfUsbTargetDeviceSelectConfigTypeInterfacesDescriptor설정하는 경우 이 멤버는 구성에 대해 선택할 인터페이스를 나타내는 USB_INTERFACE_DESCRIPTOR 구조체 배열에 대한 드라이버 제공 포인터를 포함합니다.

Types.Descriptor.NumInterfaceDescriptors

드라이버가 Type WdfUsbTargetDeviceSelectConfigTypeInterfacesDescriptor 설정하는 경우 이 멤버에는 Types.Descriptor.InterfaceDescriptors가 가리키는 인터페이스 배열에 있는 요소 수가 포함됩니다.

Types.Urb

Types.Urb.Urb

드라이버가 Type WdfUsbTargetDeviceSelectConfigTypeUrb 설정하는 경우 이 멤버는 프레임워크가 디바이스를 구성하는 데 사용하는 드라이버 초기화된 URB 구조를 지정합니다.

Types.SingleInterface

Types.SingleInterface.NumberConfiguredPipes

드라이버가 Type WdfUsbTargetDeviceSelectConfigTypeSingleInterface 설정하면 프레임워크는 인터페이스에 대해 구성된 파이프 수를 제공합니다.

Types.SingleInterface.ConfiguredUsbInterface

드라이버가 Type WdfUsbTargetDeviceSelectConfigTypeSingleInterface 설정하면 프레임워크는 구성된 인터페이스를 나타내는 USB 인터페이스 개체에 대한 핸들을 제공합니다.

Types.MultiInterface

Types.MultiInterface.NumberInterfaces

드라이버가 형식 WdfUsbTargetDeviceSelectConfigTypeInterfacesPairs 설정하면 이 멤버는 Types.MultiInterface.Pairs 배열에 있는 요소 수를 지정합니다.

Types.MultiInterface.Pairs

드라이버가 형식 WdfUsbTargetDeviceSelectConfigTypeInterfacesPairs 설정하면 이 멤버는 선택할 인터페이스를 식별하는 WDF_USB_INTERFACE_SETTING_PAIR 구조체 배열에 대한 포인터를 지정합니다.

Types.MultiInterface.NumberOfConfiguredInterfaces

드라이버가 Type WdfUsbTargetDeviceSelectConfigTypeInterfacesPairs 또는 WdfUsbTargetDeviceSelectConfigTypeMultiInterface 설정하면 프레임워크는 디바이스에 대해 구성된 인터페이스 수를 제공합니다.