IWDFUsbTargetDevice::RetrieveDeviceInformation 메서드(wudfusb.h)

[경고: UMDF 2는 UMDF의 최신 버전이며 UMDF 1을 대체합니다. 모든 새 UMDF 드라이버는 UMDF 2를 사용하여 작성해야 합니다. UMDF 1에 새 기능이 추가되지 않으며 최신 버전의 Windows 10 UMDF 1에 대한 지원이 제한됩니다. 유니버설 Windows 드라이버는 UMDF 2를 사용해야 합니다. 자세한 내용은 UMDF를 사용하여 시작 참조하세요.]

RetrieveDeviceInformation 메서드는 지정된 형식의 디바이스 정보를 검색합니다.

구문

HRESULT RetrieveDeviceInformation(
  [in]      ULONG InformationType,
  [in, out] ULONG *BufferLength,
  [out]     PVOID Buffer
);

매개 변수

[in] InformationType

UMDF 드라이버가 디바이스에 대해 요청하는 정보의 유형입니다.

[in, out] BufferLength

입력 시 RetrieveDeviceInformation 이 버퍼에 제공하는 버퍼의 크기(바이트)를 포함하는 변수에 대한 포인터입니다. 출력 시 이 매개 변수에는 Buffer에 대해 RetrieveDeviceInformation에 필요한 크기가 포함됩니다.

[out] Buffer

디바이스 정보가 포함된 버퍼를 수신하는 포인터입니다.

반환 값

RetrieveDeviceInformation 은 다음 값 중 하나를 반환합니다.

반환 코드	설명
S_ok	RetrieveDeviceInformation 이 디바이스 정보를 성공적으로 검색했습니다.
E_OUTOFMEMORY	RetrieveDeviceInformation 에서 할당 오류가 발생했습니다.
Winerror.h에 정의된 오류 코드	이 값은 WinUsb API가 반환한 오류 코드에 해당합니다.

설명

UMDF 드라이버가 InformationType 매개 변수에 전달할 수 있는 유효한 정보 유형에 대한 자세한 내용은 WinUsb_QueryDeviceInformation 함수를 참조하세요.

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

RetrieveDeviceInformation 메서드는 UMDF 요청을 생성하고 I/O 대상에 요청을 동기적으로 보냅니다.

예제

RetrieveDeviceInformation 메서드를 사용하는 방법에 대한 코드 예제는 IWDFUsbTargetPipe::SetPipePolicy를 참조하세요.

요구 사항

요구 사항	값
지원 종료	UMDF 2.0 이상에서는 사용할 수 없습니다.
대상 플랫폼	데스크톱
최소 UMDF 버전	1.5
머리글	wudfusb.h(Wudfusb.h 포함)
DLL	WUDFx.dll

추가 정보

IWDFUsbTargetDevice

WinUsb_QueryDeviceInformation