EFI_USBFN_IO_PROTOCOL. GetDeviceInfo

La función GetDeviceInfo Devuelve información específica del dispositivo en función del identificador proporcionado.

La especificación de EfiUsbDeviceInfoUnknown como Id. se trata como un parámetro no válido.

Sintaxis

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
  );

Parámetros

Éste
Puntero a la instancia de EFI_USBFN_IO_PROTOCOL.

Id
Enumeración EFI_USBFN_DEVICE_INFO_ID que contiene el identificador de dispositivo solicitado.

BufferSize
En la entrada, el tamaño del búfer en bytes. En la salida, la cantidad de datos devueltos en búfer en bytes.

Buffer
Puntero a un búfer en el que se devolverá la información solicitada como una cadena Unicode.

Valores devueltos

Esta función devuelve los valores siguientes:

Código devuelto	Descripción
EFI_SUCCESS	La función devolvió correctamente.
EFI_INVALID_PARAMETER	Si se devuelve este valor, significará que el parámetro en cuestión no es válido.
EFI_DEVICE_ERROR	El dispositivo físico notificó un error.
EFI_NOT_READY	El dispositivo físico está ocupado o no está listo para procesar esta solicitud.
EFI_BUFFER_TOO_SMALL	El búfer proporcionado no es lo suficientemente grande como para contener la cadena de solicitud.

Observaciones

Si el búfer proporcionado es demasiado pequeño o NULL, se produce un error en el método con EFI_BUFFER_TOO_SMALL y el tamaño necesario se devuelve a través de BufferSize. Todas las cadenas devueltas están en formato Unicode.

Requisitos

Rúbrica: Usuario generado