USBD_IsInterfaceVersionSupported 함수(usbdlib.h)

기본 USB 드라이버 스택이 특정 USBD 인터페이스 버전을 지원하는지 여부를 검사 위해 USB 클라이언트 드라이버에서 USBD_IsInterfaceVersionSupported 루틴을 호출합니다.

구문

BOOLEAN USBD_IsInterfaceVersionSupported(
  [in] USBD_HANDLE USBDHandle,
  [in] ULONG       USBDInterfaceVersion
);

매개 변수

[in] USBDHandle

USBD_CreateHandle 루틴에 대한 이전 호출에서 클라이언트 드라이버가 검색한 USBD 핸들입니다.

[in] USBDInterfaceVersion

USB 드라이버 스택에 대해 검사 USBD 인터페이스 버전을 나타내는 LONG 값입니다. 가능한 값에는 USBD_INTERFACE_VERSION_602 또는 USBD_INTERFACE_VERSION_600 포함할 수 있습니다. 자세한 내용은 설명 부분을 참조하세요.

반환 값

지정된 USBD 인터페이스 버전이 USB 드라이버 스택에서 지원되는 경우 USBD_IsInterfaceVersionSupported TRUE를 반환합니다. 그렇지 않으면 FALSE입니다. 자세한 내용은 설명 부분을 참조하세요.

설명

디바이스에 대해 로드된 USB 드라이버 스택은 Windows 버전, 호스트 컨트롤러 하드웨어 및 USB 디바이스에 따라 달라집니다. Windows 7 및 이전 버전의 Windows는 USBD_INTERFACE_VERSION_600 지원합니다. Windows 8 드라이버 스택에서 지원하는 USBD 인터페이스 버전은 USBD_INTERFACE_VERSION_602 USBD_INTERFACE_VERSION_600. USB 클라이언트 드라이버는 기본 드라이버 스택의 인터페이스 버전에 대해 거의 알 필요가 없습니다. 이러한 정보가 필요한 경우 클라이언트 드라이버는 USBD_IsInterfaceVersionSupported 루틴을 호출하여 특정 인터페이스 버전이 기본 드라이버 스택에서 지원되는지 여부를 검사 수 있습니다. instance 경우 클라이언트 드라이버는 USBD_IsInterfaceVersionSupported 호출하여 드라이버 스택이 USBD_INTERFACE_VERSION_602 지원하는지 여부를 확인합니다. 해당 버전을 지원하는 경우 루틴은 TRUE를 반환합니다.

루틴에는 유효한 USBD 핸들이 필요합니다( USBD_CreateHandle 대한 이전 호출에서 얻은). USBD_IsInterfaceVersionSupported Windows Vista 이상 버전의 Windows를 대상으로 하는 클라이언트 드라이버에서만 호출할 수 있습니다. 이러한 클라이언트 드라이버는 루틴을 성공적으로 호출하려면 Windows 8 대한 WDK(Windows 드라이버 키트)를 가져와야 합니다. USBD_IsInterfaceVersionSupportedUSBD_GetUSBDIVersion 루틴을 대체합니다.

USBD 인터페이스 버전은 USB 드라이버 스택에서 지원하는 기능을 나타내지 않습니다. 예를 들어 기본 드라이버 스택이 USBD_INTERFACE_VERSION_602 지원한다고 해서 클라이언트 드라이버는 드라이버가 정적 스트림 기능을 사용할 수 있다고 가정 해서는 안 됩니다 . 드라이버 스택이 기능을 지원하더라도 호스트 컨트롤러 하드웨어 또는 USB 디바이스가 스트림을 지원하지 않을 수 있기 때문입니다. USB 드라이버 스택이 특정 기능을 지원하는지 여부를 확인하려면 USBD_QueryUsbCapability 호출합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 8 WDK가 필요합니다. Windows Vista 이상 버전의 Windows 운영 체제를 대상으로 합니다.
대상 플랫폼	데스크톱
머리글	usbdlib.h
라이브러리	Usbdex.lib
IRQL	PASSIVE_LEVEL