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. 출력 시 이 매개 변수에는 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