mirror of https://github.com/acidanthera/audk.git
687 lines
28 KiB
C
687 lines
28 KiB
C
/** @file
|
|
Provides most USB APIs to support the Hid requests defined in USB Hid 1.1 spec
|
|
and the standard requests defined in USB 1.1 spec.
|
|
|
|
Copyright (c) 2006 - 2008, Intel Corporation. All rights reserved.<BR>
|
|
Copyright (c) 2024, American Megatrends Intenational LLC. All rights reserved.<BR>
|
|
SPDX-License-Identifier: BSD-2-Clause-Patent
|
|
|
|
**/
|
|
|
|
#ifndef __USB_DXE_LIB_H__
|
|
#define __USB_DXE_LIB_H__
|
|
|
|
#include <Protocol/UsbIo.h>
|
|
|
|
/**
|
|
Get the descriptor of the specified USB HID interface.
|
|
|
|
Submit a UsbGetHidDescriptor() request for the USB device specified by UsbIo
|
|
and Interface, and return the HID descriptor in HidDescriptor.
|
|
If UsbIo is NULL, then ASSERT().
|
|
If HidDescriptor is NULL, then ASSERT().
|
|
|
|
@param UsbIo A pointer to the USB I/O Protocol instance for the specific USB target.
|
|
@param Interface The index of the HID interface on the USB target.
|
|
@param HidDescriptor Pointer to the USB HID descriptor that was retrieved from
|
|
the specified USB target and interface. Type EFI_USB_HID_DESCRIPTOR
|
|
is defined in the MDE Package Industry Standard include file Usb.h.
|
|
|
|
@retval EFI_SUCCESS The request executed successfully.
|
|
@retval EFI_TIMEOUT A timeout occurred executing the request.
|
|
@retval EFI_DEVICE_ERROR The request failed due to a device error.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
UsbGetHidDescriptor (
|
|
IN EFI_USB_IO_PROTOCOL *UsbIo,
|
|
IN UINT8 Interface,
|
|
OUT EFI_USB_HID_DESCRIPTOR *HidDescriptor
|
|
);
|
|
|
|
/**
|
|
Get the report descriptor of the specified USB HID interface.
|
|
|
|
Submit a USB get HID report descriptor request for the USB device specified by
|
|
UsbIo and Interface, and return the report descriptor in DescriptorBuffer.
|
|
If UsbIo is NULL, then ASSERT().
|
|
If DescriptorBuffer is NULL, then ASSERT().
|
|
|
|
@param UsbIo A pointer to the USB I/O Protocol instance for the specific USB target.
|
|
@param Interface The index of the report interface on the USB target.
|
|
@param DescriptorLength The size, in bytes, of DescriptorBuffer.
|
|
@param DescriptorBuffer A pointer to the buffer to store the report class descriptor.
|
|
|
|
@retval EFI_SUCCESS The request executed successfully.
|
|
@retval EFI_OUT_OF_RESOURCES The request could not be completed because the
|
|
buffer specified by DescriptorLength and DescriptorBuffer
|
|
is not large enough to hold the result of the request.
|
|
@retval EFI_TIMEOUT A timeout occurred executing the request.
|
|
@retval EFI_DEVICE_ERROR The request failed due to a device error.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
UsbGetReportDescriptor (
|
|
IN EFI_USB_IO_PROTOCOL *UsbIo,
|
|
IN UINT8 Interface,
|
|
IN UINT16 DescriptorLength,
|
|
OUT UINT8 *DescriptorBuffer
|
|
);
|
|
|
|
/**
|
|
Get the HID protocol of the specified USB HID interface.
|
|
|
|
Submit a USB get HID protocol request for the USB device specified by UsbIo
|
|
and Interface, and return the protocol retrieved in Protocol.
|
|
If UsbIo is NULL, then ASSERT().
|
|
If Protocol is NULL, then ASSERT().
|
|
|
|
@param UsbIo A pointer to the USB I/O Protocol instance for the specific USB target.
|
|
@param Interface The index of the report interface on the USB target.
|
|
@param Protocol A pointer to the protocol for the specified USB target.
|
|
|
|
@retval EFI_SUCCESS The request executed successfully.
|
|
@retval EFI_TIMEOUT A timeout occurred executing the request.
|
|
@retval EFI_DEVICE_ERROR The request failed due to a device error.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
UsbGetProtocolRequest (
|
|
IN EFI_USB_IO_PROTOCOL *UsbIo,
|
|
IN UINT8 Interface,
|
|
OUT UINT8 *Protocol
|
|
);
|
|
|
|
/**
|
|
Set the HID protocol of the specified USB HID interface.
|
|
|
|
Submit a USB set HID protocol request for the USB device specified by UsbIo
|
|
and Interface, and set the protocol to the value specified by Protocol.
|
|
If UsbIo is NULL, then ASSERT().
|
|
|
|
@param UsbIo A pointer to the USB I/O Protocol instance for the specific USB target.
|
|
@param Interface The index of the report interface on the USB target.
|
|
@param Protocol The protocol value to set for the specified USB target.
|
|
|
|
@retval EFI_SUCCESS The request executed successfully.
|
|
@retval EFI_TIMEOUT A timeout occurred executing the request.
|
|
@retval EFI_DEVICE_ERROR The request failed due to a device error.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
UsbSetProtocolRequest (
|
|
IN EFI_USB_IO_PROTOCOL *UsbIo,
|
|
IN UINT8 Interface,
|
|
IN UINT8 Protocol
|
|
);
|
|
|
|
/**
|
|
Set the idle rate of the specified USB HID report.
|
|
|
|
Submit a USB set HID report idle request for the USB device specified by UsbIo,
|
|
Interface, and ReportId, and set the idle rate to the value specified by Duration.
|
|
If UsbIo is NULL, then ASSERT().
|
|
|
|
@param UsbIo A pointer to the USB I/O Protocol instance for the specific USB target.
|
|
@param Interface The index of the report interface on the USB target.
|
|
@param ReportId The identifier of the report to retrieve.
|
|
@param Duration The idle rate to set for the specified USB target.
|
|
|
|
@retval EFI_SUCCESS The request executed successfully.
|
|
@retval EFI_TIMEOUT A timeout occurred executing the request.
|
|
@retval EFI_DEVICE_ERROR The request failed due to a device error.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
UsbSetIdleRequest (
|
|
IN EFI_USB_IO_PROTOCOL *UsbIo,
|
|
IN UINT8 Interface,
|
|
IN UINT8 ReportId,
|
|
IN UINT8 Duration
|
|
);
|
|
|
|
/**
|
|
Get the idle rate of the specified USB HID report.
|
|
|
|
Submit a USB get HID report idle request for the USB device specified by UsbIo,
|
|
Interface, and ReportId, and return the ide rate in Duration.
|
|
If UsbIo is NULL, then ASSERT().
|
|
If Duration is NULL, then ASSERT().
|
|
|
|
@param UsbIo A pointer to the USB I/O Protocol instance for the specific USB target.
|
|
@param Interface The index of the report interface on the USB target.
|
|
@param ReportId The identifier of the report to retrieve.
|
|
@param Duration A pointer to the idle rate retrieved from the specified USB target.
|
|
|
|
@retval EFI_SUCCESS The request executed successfully.
|
|
@retval EFI_TIMEOUT A timeout occurred executing the request.
|
|
@retval EFI_DEVICE_ERROR The request failed due to a device error.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
UsbGetIdleRequest (
|
|
IN EFI_USB_IO_PROTOCOL *UsbIo,
|
|
IN UINT8 Interface,
|
|
IN UINT8 ReportId,
|
|
OUT UINT8 *Duration
|
|
);
|
|
|
|
/**
|
|
Set the report descriptor of the specified USB HID interface.
|
|
|
|
Submit a USB set HID report request for the USB device specified by UsbIo,
|
|
Interface, ReportId, and ReportType, and set the report descriptor using the
|
|
buffer specified by ReportLength and Report.
|
|
If UsbIo is NULL, then ASSERT().
|
|
If Report is NULL, then ASSERT().
|
|
|
|
@param UsbIo A pointer to the USB I/O Protocol instance for the specific USB target.
|
|
@param Interface The index of the report interface on the USB target.
|
|
@param ReportId The identifier of the report to retrieve.
|
|
@param ReportType The type of report to retrieve.
|
|
@param ReportLength The size, in bytes, of Report.
|
|
@param Report A pointer to the report descriptor buffer to set.
|
|
|
|
@retval EFI_SUCCESS The request executed successfully.
|
|
@retval EFI_TIMEOUT A timeout occurred executing the request.
|
|
@retval EFI_DEVICE_ERROR The request failed due to a device error.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
UsbSetReportRequest (
|
|
IN EFI_USB_IO_PROTOCOL *UsbIo,
|
|
IN UINT8 Interface,
|
|
IN UINT8 ReportId,
|
|
IN UINT8 ReportType,
|
|
IN UINT16 ReportLen,
|
|
IN UINT8 *Report
|
|
);
|
|
|
|
/**
|
|
Get the report descriptor of the specified USB HID interface.
|
|
|
|
Submit a USB get HID report request for the USB device specified by UsbIo,
|
|
Interface, ReportId, and ReportType, and return the report in the buffer
|
|
specified by Report.
|
|
If UsbIo is NULL, then ASSERT().
|
|
If Report is NULL, then ASSERT().
|
|
|
|
@param UsbIo A pointer to the USB I/O Protocol instance for the specific USB target.
|
|
@param Interface The index of the report interface on the USB target.
|
|
@param ReportId The identifier of the report to retrieve.
|
|
@param ReportType The type of report to retrieve.
|
|
@param ReportLength The size, in bytes, of Report.
|
|
@param Report A pointer to the buffer to store the report descriptor.
|
|
|
|
@retval EFI_SUCCESS The request executed successfully.
|
|
@retval EFI_OUT_OF_RESOURCES The request could not be completed because the
|
|
buffer specified by ReportLength and Report is not
|
|
large enough to hold the result of the request.
|
|
@retval EFI_TIMEOUT A timeout occurred executing the request.
|
|
@retval EFI_DEVICE_ERROR The request failed due to a device error.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
UsbGetReportRequest (
|
|
IN EFI_USB_IO_PROTOCOL *UsbIo,
|
|
IN UINT8 Interface,
|
|
IN UINT8 ReportId,
|
|
IN UINT8 ReportType,
|
|
IN UINT16 ReportLen,
|
|
OUT UINT8 *Report
|
|
);
|
|
|
|
/**
|
|
Get the descriptor of the specified USB device.
|
|
|
|
Submit a USB get descriptor request for the USB device specified by UsbIo, Value,
|
|
and Index, and return the descriptor in the buffer specified by Descriptor.
|
|
The status of the transfer is returned in Status.
|
|
If UsbIo is NULL, then ASSERT().
|
|
If Descriptor is NULL, then ASSERT().
|
|
If Status is NULL, then ASSERT().
|
|
|
|
@param UsbIo A pointer to the USB I/O Protocol instance for the specific USB target.
|
|
@param Value The device request value.
|
|
@param Index The device request index.
|
|
@param DescriptorLength The size, in bytes, of Descriptor.
|
|
@param Descriptor A pointer to the descriptor buffer to get.
|
|
@param Status A pointer to the status of the transfer.
|
|
|
|
@retval EFI_SUCCESS The request executed successfully.
|
|
@retval EFI_OUT_OF_RESOURCES The request could not be completed because the
|
|
buffer specified by DescriptorLength and Descriptor
|
|
is not large enough to hold the result of the request.
|
|
@retval EFI_TIMEOUT A timeout occurred executing the request.
|
|
@retval EFI_DEVICE_ERROR The request failed due to a device error. The transfer
|
|
status is returned in Status.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
UsbGetDescriptor (
|
|
IN EFI_USB_IO_PROTOCOL *UsbIo,
|
|
IN UINT16 Value,
|
|
IN UINT16 Index,
|
|
IN UINT16 DescriptorLength,
|
|
OUT VOID *Descriptor,
|
|
OUT UINT32 *Status
|
|
);
|
|
|
|
/**
|
|
Set the descriptor of the specified USB device.
|
|
|
|
Submit a USB set descriptor request for the USB device specified by UsbIo,
|
|
Value, and Index, and set the descriptor using the buffer specified by DesriptorLength
|
|
and Descriptor. The status of the transfer is returned in Status.
|
|
If UsbIo is NULL, then ASSERT().
|
|
If Descriptor is NULL, then ASSERT().
|
|
If Status is NULL, then ASSERT().
|
|
|
|
@param UsbIo A pointer to the USB I/O Protocol instance for the specific USB target.
|
|
@param Value The device request value.
|
|
@param Index The device request index.
|
|
@param DescriptorLength The size, in bytes, of Descriptor.
|
|
@param Descriptor A pointer to the descriptor buffer to set.
|
|
@param Status A pointer to the status of the transfer.
|
|
|
|
@retval EFI_SUCCESS The request executed successfully.
|
|
@retval EFI_TIMEOUT A timeout occurred executing the request.
|
|
@retval EFI_DEVICE_ERROR The request failed due to a device error.
|
|
The transfer status is returned in Status.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
UsbSetDescriptor (
|
|
IN EFI_USB_IO_PROTOCOL *UsbIo,
|
|
IN UINT16 Value,
|
|
IN UINT16 Index,
|
|
IN UINT16 DescriptorLength,
|
|
IN VOID *Descriptor,
|
|
OUT UINT32 *Status
|
|
);
|
|
|
|
/**
|
|
Get the interface setting of the specified USB device.
|
|
|
|
Submit a USB get interface request for the USB device specified by UsbIo,
|
|
and Interface, and place the result in the buffer specified by AlternateSetting.
|
|
The status of the transfer is returned in Status.
|
|
If UsbIo is NULL, then ASSERT().
|
|
If AlternateSetting is NULL, then ASSERT().
|
|
If Status is NULL, then ASSERT().
|
|
|
|
@param UsbIo A pointer to the USB I/O Protocol instance for the specific USB target.
|
|
@param Interface The interface index value.
|
|
@param AlternateSetting A pointer to the alternate setting to be retrieved.
|
|
@param Status A pointer to the status of the transfer.
|
|
|
|
@retval EFI_SUCCESS The request executed successfully.
|
|
@retval EFI_TIMEOUT A timeout occurred executing the request.
|
|
@retval EFI_DEVICE_ERROR The request failed due to a device error.
|
|
The transfer status is returned in Status.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
UsbGetInterface (
|
|
IN EFI_USB_IO_PROTOCOL *UsbIo,
|
|
IN UINT16 Interface,
|
|
OUT UINT16 *AlternateSetting,
|
|
OUT UINT32 *Status
|
|
);
|
|
|
|
/**
|
|
Set the interface setting of the specified USB device.
|
|
|
|
Submit a USB set interface request for the USB device specified by UsbIo, and
|
|
Interface, and set the alternate setting to the value specified by AlternateSetting.
|
|
The status of the transfer is returned in Status.
|
|
If UsbIo is NULL, then ASSERT().
|
|
If Status is NULL, then ASSERT().
|
|
|
|
@param UsbIo A pointer to the USB I/O Protocol instance for the specific USB target.
|
|
@param Interface The interface index value.
|
|
@param AlternateSetting The alternate setting to be set.
|
|
@param Status A pointer to the status of the transfer.
|
|
|
|
@retval EFI_SUCCESS The request executed successfully.
|
|
@retval EFI_TIMEOUT A timeout occurred executing the request.
|
|
@retval EFI_SUCCESS The request failed due to a device error.
|
|
The transfer status is returned in Status.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
UsbSetInterface (
|
|
IN EFI_USB_IO_PROTOCOL *UsbIo,
|
|
IN UINT16 Interface,
|
|
IN UINT16 AlternateSetting,
|
|
OUT UINT32 *Status
|
|
);
|
|
|
|
/**
|
|
Get the device configuration.
|
|
|
|
Submit a USB get configuration request for the USB device specified by UsbIo
|
|
and place the result in the buffer specified by ConfigurationValue. The status
|
|
of the transfer is returned in Status.
|
|
If UsbIo is NULL, then ASSERT().
|
|
If ConfigurationValue is NULL, then ASSERT().
|
|
If Status is NULL, then ASSERT().
|
|
|
|
@param UsbIo A pointer to the USB I/O Protocol instance for the specific USB target.
|
|
@param ConfigurationValue A pointer to the device configuration to be retrieved.
|
|
@param Status A pointer to the status of the transfer.
|
|
|
|
@retval EFI_SUCCESS The request executed successfully.
|
|
@retval EFI_TIMEOUT A timeout occurred executing the request.
|
|
@retval EFI_DEVICE_ERROR The request failed due to a device error.
|
|
The transfer status is returned in Status.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
UsbGetConfiguration (
|
|
IN EFI_USB_IO_PROTOCOL *UsbIo,
|
|
OUT UINT16 *ConfigurationValue,
|
|
OUT UINT32 *Status
|
|
);
|
|
|
|
/**
|
|
Set the device configuration.
|
|
|
|
Submit a USB set configuration request for the USB device specified by UsbIo
|
|
and set the device configuration to the value specified by ConfigurationValue.
|
|
The status of the transfer is returned in Status.
|
|
If UsbIo is NULL, then ASSERT().
|
|
If Status is NULL, then ASSERT().
|
|
|
|
@param UsbIo A pointer to the USB I/O Protocol instance for the specific USB target.
|
|
@param ConfigurationValue The device configuration value to be set.
|
|
@param Status A pointer to the status of the transfer.
|
|
|
|
@retval EFI_SUCCESS The request executed successfully.
|
|
@retval EFI_TIMEOUT A timeout occurred executing the request.
|
|
@retval EFI_DEVICE_ERROR The request failed due to a device error.
|
|
The transfer status is returned in Status.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
UsbSetConfiguration (
|
|
IN EFI_USB_IO_PROTOCOL *UsbIo,
|
|
IN UINT16 ConfigurationValue,
|
|
OUT UINT32 *Status
|
|
);
|
|
|
|
/**
|
|
Set the specified feature of the specified device.
|
|
|
|
Submit a USB set device feature request for the USB device specified by UsbIo,
|
|
Recipient, and Target to the value specified by Value. The status of the
|
|
transfer is returned in Status.
|
|
If UsbIo is NULL, then ASSERT().
|
|
If Status is NULL, then ASSERT().
|
|
|
|
@param UsbIo A pointer to the USB I/O Protocol instance for the specific USB target.
|
|
@param Recipient The USB data recipient type (i.e. Device, Interface, Endpoint).
|
|
Type USB_TYPES_DEFINITION is defined in the MDE Package Industry
|
|
Standard include file Usb.h.
|
|
@param Value The value of the feature to be set.
|
|
@param Target The index of the device to be set.
|
|
@param Status A pointer to the status of the transfer.
|
|
|
|
@retval EFI_SUCCESS The request executed successfully.
|
|
@retval EFI_TIMEOUT A timeout occurred executing the request.
|
|
@retval EFI_DEVICE_ERROR The request failed due to a device error.
|
|
The transfer status is returned in Status.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
UsbSetFeature (
|
|
IN EFI_USB_IO_PROTOCOL *UsbIo,
|
|
IN USB_TYPES_DEFINITION Recipient,
|
|
IN UINT16 Value,
|
|
IN UINT16 Target,
|
|
OUT UINT32 *Status
|
|
);
|
|
|
|
/**
|
|
Clear the specified feature of the specified device.
|
|
|
|
Submit a USB clear device feature request for the USB device specified by UsbIo,
|
|
Recipient, and Target to the value specified by Value. The status of the transfer
|
|
is returned in Status.
|
|
If UsbIo is NULL, then ASSERT().
|
|
If Status is NULL, then ASSERT().
|
|
|
|
@param UsbIo A pointer to the USB I/O Protocol instance for the specific USB target.
|
|
@param Recipient The USB data recipient type (i.e. Device, Interface, Endpoint).
|
|
Type USB_TYPES_DEFINITION is defined in the MDE Package Industry Standard
|
|
include file Usb.h.
|
|
@param Value The value of the feature to be cleared.
|
|
@param Target The index of the device to be cleared.
|
|
@param Status A pointer to the status of the transfer.
|
|
|
|
@retval EFI_SUCCESS The request executed successfully.
|
|
@retval EFI_TIMEOUT A timeout occurred executing the request.
|
|
@retval EFI_DEVICE_ERROR The request failed due to a device error.
|
|
The transfer status is returned in Status.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
UsbClearFeature (
|
|
IN EFI_USB_IO_PROTOCOL *UsbIo,
|
|
IN USB_TYPES_DEFINITION Recipient,
|
|
IN UINT16 Value,
|
|
IN UINT16 Target,
|
|
OUT UINT32 *Status
|
|
);
|
|
|
|
/**
|
|
Get the status of the specified device.
|
|
|
|
Submit a USB device get status request for the USB device specified by UsbIo,
|
|
Recipient, and Target, and place the result in the buffer specified by DeviceStatus.
|
|
The status of the transfer is returned in Status.
|
|
If UsbIo is NULL, then ASSERT().
|
|
If DeviceStatus is NULL, then ASSERT().
|
|
If Status is NULL, then ASSERT().
|
|
|
|
@param UsbIo A pointer to the USB I/O Protocol instance for the specific USB target.
|
|
@param Recipient The USB data recipient type (i.e. Device, Interface, Endpoint).
|
|
Type USB_TYPES_DEFINITION is defined in the MDE Package Industry Standard
|
|
include file Usb.h.
|
|
@param Target The index of the device to be get the status of.
|
|
@param DeviceStatus A pointer to the device status to be retrieved.
|
|
@param Status A pointer to the status of the transfer.
|
|
|
|
@retval EFI_SUCCESS The request executed successfully.
|
|
@retval EFI_TIMEOUT A timeout occurred executing the request.
|
|
@retval EFI_DEVICE_ERROR The request failed due to a device error.
|
|
The transfer status is returned in Status.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
UsbGetStatus (
|
|
IN EFI_USB_IO_PROTOCOL *UsbIo,
|
|
IN USB_TYPES_DEFINITION Recipient,
|
|
IN UINT16 Target,
|
|
OUT UINT16 *DeviceStatus,
|
|
OUT UINT32 *Status
|
|
);
|
|
|
|
/**
|
|
Clear halt feature of the specified usb endpoint.
|
|
|
|
Retrieve the USB endpoint descriptor specified by UsbIo and EndPoint.
|
|
If the USB endpoint descriptor can not be retrieved, then return EFI_NOT_FOUND.
|
|
If the endpoint descriptor is found, then clear the halt feature of this USB endpoint.
|
|
The status of the transfer is returned in Status.
|
|
If UsbIo is NULL, then ASSERT().
|
|
If Status is NULL, then ASSERT().
|
|
|
|
@param UsbIo A pointer to the USB I/O Protocol instance for the specific USB target.
|
|
@param Endpoint The endpoint address.
|
|
@param Status A pointer to the status of the transfer.
|
|
|
|
@retval EFI_SUCCESS The request executed successfully.
|
|
@retval EFI_TIMEOUT A timeout occurred executing the request.
|
|
@retval EFI_DEVICE_ERROR The request failed due to a device error.
|
|
The transfer status is returned in Status.
|
|
@retval EFI_NOT_FOUND The specified USB endpoint descriptor can not be found
|
|
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
UsbClearEndpointHalt (
|
|
IN EFI_USB_IO_PROTOCOL *UsbIo,
|
|
IN UINT8 Endpoint,
|
|
OUT UINT32 *Status
|
|
);
|
|
|
|
/**
|
|
Retrieve the interface descriptor details from the interface setting.
|
|
|
|
This is an extended version of UsbIo->GetInterfaceDescriptor. It returns the interface
|
|
descriptor for an alternate setting of the interface without executing SET_INTERFACE
|
|
transfer. It also returns the number of class specific interfaces.
|
|
AlternateSetting parameter is the zero-based interface descriptor index that is used in USB
|
|
interface descriptor as USB_INTERFACE_DESCRIPTOR.AlternateSetting.
|
|
|
|
@param[in] This A pointer to the EFI_USB_IO_PROTOCOL instance.
|
|
@param[in] AlternateSetting Interface alternate setting.
|
|
@param[out] Descriptor The caller allocated buffer to return the contents of the Interface descriptor.
|
|
@param[out] CsInterfaceNumber Number of class specific interfaces for this interface setting.
|
|
|
|
@retval EFI_SUCCESS Output parameters were updated successfully.
|
|
@retval EFI_INVALID_PARAMETER Descriptor or CsInterfaceNumber is NULL.
|
|
@retval EFI_UNSUPPORTED Setting is greater than the number of alternate settings in this interface.
|
|
@retval EFI_DEVICE_ERROR Error reading device data.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
UsbGetInterfaceDescriptorSetting (
|
|
IN EFI_USB_IO_PROTOCOL *This,
|
|
IN UINT16 AlternateSetting,
|
|
OUT EFI_USB_INTERFACE_DESCRIPTOR *Descriptor,
|
|
OUT UINTN *CsInterfacesNumber
|
|
);
|
|
|
|
/**
|
|
Retrieve the endpoint descriptor from the interface setting.
|
|
|
|
This is an extended version of UsbIo->GetEndpointDescriptor. It returns the endpoint
|
|
descriptor for an alternate setting of a given interface.
|
|
AlternateSetting parameter is the zero-based interface descriptor index that is used in USB
|
|
interface descriptor as USB_INTERFACE_DESCRIPTOR.AlternateSetting.
|
|
|
|
Note: The total number of endpoints can be retrieved from the interface descriptor
|
|
returned by EDKII_USBIO_EXT_GET_INTERFACE_DESCRIPTOR function.
|
|
|
|
@param[in] This A pointer to the EFI_USB_IO_PROTOCOL instance.
|
|
@param[in] AlternateSetting Interface alternate setting.
|
|
@param[in] Index Index of the endpoint to retrieve. The valid range is 0..15.
|
|
@param[out] Descriptor A pointer to the caller allocated USB Interface Descriptor.
|
|
|
|
@retval EFI_SUCCESS Output parameters were updated successfully.
|
|
@retval EFI_INVALID_PARAMETER Descriptor is NULL.
|
|
@retval EFI_UNSUPPORTED Setting is greater than the number of alternate settings in this interface.
|
|
@retval EFI_NOT_FOUND Index is greater than the number of endpoints in this interface.
|
|
@retval EFI_DEVICE_ERROR Error reading device data.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
UsbGetEndpointDescriptorSetting (
|
|
IN EFI_USB_IO_PROTOCOL *This,
|
|
IN UINT16 AlternateSetting,
|
|
IN UINTN Index,
|
|
OUT EFI_USB_ENDPOINT_DESCRIPTOR *Descriptor
|
|
);
|
|
|
|
/**
|
|
Retrieve class specific interface descriptor.
|
|
|
|
AlternateSetting parameter is the zero-based interface descriptor index that is used in USB
|
|
interface descriptor as USB_INTERFACE_DESCRIPTOR.AlternateSetting.
|
|
|
|
@param[in] This A pointer to the EFI_USB_IO_PROTOCOL instance.
|
|
@param[in] AlternateSetting Interface alternate setting.
|
|
@param[in] Index Zero-based index of the class specific interface.
|
|
@param[in][out] BufferSize On input, the size in bytes of the return Descriptor buffer.
|
|
On output the size of data returned in Descriptor.
|
|
@param[out] Descriptor The buffer to return the contents of the class specific interface descriptor. May
|
|
be NULL with a zero BufferSize in order to determine the size buffer needed.
|
|
|
|
@retval EFI_SUCCESS Output parameters were updated successfully.
|
|
@retval EFI_INVALID_PARAMETER BufferSize is NULL.
|
|
Buffer is NULL and *BufferSize is not zero.
|
|
@retval EFI_UNSUPPORTED Setting is greater than the number of alternate settings in this interface.
|
|
@retval EFI_NOT_FOUND Index is greater than the number of class specific interfaces.
|
|
@retval EFI_BUFFER_TOO_SMALL The BufferSize is too small for the result. BufferSize has been updated with the size
|
|
needed to complete the request.
|
|
@retval EFI_DEVICE_ERROR Error reading device data.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
UsbGetCsInterfaceDescriptor (
|
|
IN EFI_USB_IO_PROTOCOL *This,
|
|
IN UINT16 AlternateSetting,
|
|
IN UINTN Index,
|
|
IN OUT UINTN *BufferSize,
|
|
OUT VOID *Buffer
|
|
);
|
|
|
|
/**
|
|
Retrieve class specific endpoint descriptor.
|
|
|
|
AlternateSetting parameter is the zero-based interface descriptor index that is used in USB
|
|
interface descriptor as USB_INTERFACE_DESCRIPTOR.AlternateSetting.
|
|
|
|
@param[in] This A pointer to the EFI_USB_IO_PROTOCOL instance.
|
|
@param[in] AlternateSetting Interface alternate setting.
|
|
@param[in] Index Zero-based index of the non-zero endpoint.
|
|
@param[in][out] BufferSize On input, the size in bytes of the return Descriptor buffer.
|
|
On output the size of data returned in Descriptor.
|
|
@param[out] Descriptor The buffer to return the contents of the class specific endpoint descriptor. May
|
|
be NULL with a zero BufferSize in order to determine the size buffer needed.
|
|
|
|
@retval EFI_SUCCESS Output parameters were updated successfully.
|
|
@retval EFI_INVALID_PARAMETER BufferSize is NULL.
|
|
Buffer is NULL and *BufferSize is not zero.
|
|
@retval EFI_UNSUPPORTED Setting is greater than the number of alternate settings in this interface.
|
|
@retval EFI_NOT_FOUND Index is greater than the number of endpoints in this interface.
|
|
Endpoint does not have class specific endpoint descriptor.
|
|
@retval EFI_BUFFER_TOO_SMALL The BufferSize is too small for the result. BufferSize has been updated with the size
|
|
needed to complete the request.
|
|
@retval EFI_DEVICE_ERROR Error reading device data.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
UsbGetCsEndpointDescriptor (
|
|
IN EFI_USB_IO_PROTOCOL *This,
|
|
IN UINT16 AlternateSetting,
|
|
IN UINTN Index,
|
|
IN OUT UINTN *BufferSize,
|
|
OUT VOID *Buffer
|
|
);
|
|
|
|
#endif
|