다음을 통해 공유

EFI_USBFN_IO_PROTOCOL. GetDeviceInfo

  • 아티클

GetDeviceInfo 함수는 제공된 식별자를 기반으로 디바이스별 정보를 반환합니다.

EfiUsbDeviceInfoUnknown을 ID로 지정하면 잘못된 매개 변수로 처리됩니다.

구문

typedef
EFI_STATUS
(EFIAPI * EFI_USBFN_IO_GET_DEVICE_INFO) (
  IN EFI_USBFN_IO_PROTOCOL      *This,
  IN EFI_USBFN_DEVICE_INFO_ID   Id,
  IN OUT UINTN                  *BufferSize,
  OUT VOID                      *Buffer OPTIONAL
  );

매개 변수

This
EFI_USBFN_IO_PROTOCOL instance 대한 포인터입니다.

ID
요청된 디바이스 ID를 포함하는 EFI_USBFN_DEVICE_INFO_ID 열거형입니다.

BufferSize
입력에서 버퍼의 크기(바이트)입니다. 출력에서 버퍼로 반환된 데이터의 양(바이트)입니다.

Buffer
요청된 정보가 유니코드 문자열로 반환되는 버퍼에 대한 포인터입니다.

반환 값

이 함수는 다음 값을 반환합니다.

반환 코드 설명
EFI_SUCCESS 함수가 성공적으로 반환되었습니다.
EFI_INVALID_PARAMETER 매개 변수가 잘못되었습니다.
EFI_DEVICE_ERROR 물리적 디바이스에서 오류를 보고했습니다.
EFI_NOT_READY 물리적 디바이스가 사용 중이거나 이 요청을 처리할 준비가 되지 않았습니다.
EFI_BUFFER_TOO_SMALL 제공된 버퍼가 요청 문자열을 보유할 만큼 크지 않습니다.

설명

제공된 버퍼가 너무 작거나 NULL이면 메서드가 EFI_BUFFER_TOO_SMALL 실패하고 필요한 크기가 BufferSize를 통해 반환됩니다. 반환된 모든 문자열은 유니코드 형식입니다.

요구 사항

헤더: 생성된 사용자