WinUsb_QueryDeviceInformation 함수(winusb.h)

WinUsb_QueryDeviceInformation 함수는 WinUSB 인터페이스 핸들과 연결된 물리적 디바이스에 대한 정보를 가져옵니다.

구문

BOOL WinUsb_QueryDeviceInformation(
  [in]      WINUSB_INTERFACE_HANDLE InterfaceHandle,
  [in]      ULONG                   InformationType,
  [in, out] PULONG                  BufferLength,
  [out]     PVOID                   Buffer
);

매개 변수

[in] InterfaceHandle

WinUsb_Initialize 반환되는 디바이스의 첫 번째 인터페이스에 대한 불투명 핸들입니다.

[in] InformationType

검색할 인터페이스 정보 값을 지정하는 값입니다.

입력할 때 InformationType 의 값은 DEVICE_SPEED(0x01)이어야 합니다.

[in, out] BufferLength

읽을 최대 바이트 수입니다. 이 숫자는 버퍼의 크기(바이트)보다 작거나 같아야 합니다. 출력에서 BufferLength 는 버퍼에 복사된 실제 바이트 수로 설정됩니다.

[out] Buffer

요청된 값을 수신하는 호출자가 할당한 버퍼입니다.

InformationType이 DEVICE_SPEED 성공적으로 반환되면 버퍼는 디바이스의 작동 속도를 나타냅니다. 0x03 고속 이상을 나타냅니다. 0x01 전속 또는 하한을 나타냅니다.

반환 값

WinUsb_QueryDeviceInformation 작업이 성공하면 TRUE 를 반환합니다. 그렇지 않으면 이 루틴은 FALSE를 반환하고 호출자는 GetLastError를 호출하여 기록된 오류를 검색할 수 있습니다.

GetLastError 는 다음 오류 코드를 반환할 수 있습니다.

반환 코드	설명
ERROR_INVALID_HANDLE	호출자가 InterfaceHandle 매개 변수에서 NULL을 전달했습니다.

요구 사항

대상 플랫폼	유니버설
헤더	winusb.h(Winusb.h 포함)
라이브러리	Winusb.lib
DLL	Winusb.dll

추가 정보

WinUSB

WinUSB 함수

WinUsb_Initialize