Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit c73a4671 authored by Elliott Hughes's avatar Elliott Hughes
Browse files

Add __INTRODUCED_IN annotations to <amidi/midi.h>. 

Bug: https://github.com/android-ndk/ndk/issues/706
Test: builds
Change-Id: I3f68f1e7c407b1208e943d15f74a9f32846a04b6
parent 956dbb07

media/native/midi/include/midi.h

+13 −13
Original line number Diff line number Diff line
@@ -71,7 +71,7 @@ enum { 
  *  @see AMEDIA_ERROR_UNKNOWN {@link AMEDIA_ERROR_UNKNOWN} - an unknown error occurred.

 */

media_status_t AMIDI_API AMidiDevice_fromJava(

        JNIEnv *env, jobject midiDeviceObj, AMidiDevice **outDevicePtrPtr);

        JNIEnv *env, jobject midiDeviceObj, AMidiDevice **outDevicePtrPtr) __INTRODUCED_IN(29);



/**

 * Disconnects the native Midi Device Object from the associated Java MidiDevice object.
@@ -88,7 +88,7 @@ media_status_t AMIDI_API AMidiDevice_fromJava( 
 *  - the JNI interface initialization to the associated java MidiDevice failed.

 *  @see AMEDIA_ERROR_UNKNOWN {@link AMEDIA_ERROR_UNKNOWN} - couldn't retrieve the device info.

 */

media_status_t AMIDI_API AMidiDevice_release(const AMidiDevice *midiDevice);

media_status_t AMIDI_API AMidiDevice_release(const AMidiDevice *midiDevice) __INTRODUCED_IN(29);



/**

 * Gets the MIDI device type.
@@ -104,7 +104,7 @@ media_status_t AMIDI_API AMidiDevice_release(const AMidiDevice *midiDevice); 
 *  parameter is NULL.

 *  @see AMEDIA_ERROR_UNKNOWN {@link AMEDIA_ERROR_UNKNOWN} - Unknown error.

 */

int32_t AMIDI_API AMidiDevice_getType(const AMidiDevice *device);

int32_t AMIDI_API AMidiDevice_getType(const AMidiDevice *device) __INTRODUCED_IN(29);



/**

 * Gets the number of input (sending) ports available on the specified MIDI device.
@@ -117,7 +117,7 @@ int32_t AMIDI_API AMidiDevice_getType(const AMidiDevice *device); 
 *  parameter is NULL.

 *  @see AMEDIA_ERROR_UNKNOWN {@link AMEDIA_ERROR_UNKNOWN} - couldn't retrieve the device info.

 */

ssize_t AMIDI_API AMidiDevice_getNumInputPorts(const AMidiDevice *device);

ssize_t AMIDI_API AMidiDevice_getNumInputPorts(const AMidiDevice *device) __INTRODUCED_IN(29);



/**

 * Gets the number of output (receiving) ports available on the specified MIDI device.
@@ -130,7 +130,7 @@ ssize_t AMIDI_API AMidiDevice_getNumInputPorts(const AMidiDevice *device); 
 *  parameter is NULL.

 *  @see AMEDIA_ERROR_UNKNOWN {@link AMEDIA_ERROR_UNKNOWN}- couldn't retrieve the device info.

 */

ssize_t AMIDI_API AMidiDevice_getNumOutputPorts(const AMidiDevice *device);

ssize_t AMIDI_API AMidiDevice_getNumOutputPorts(const AMidiDevice *device) __INTRODUCED_IN(29);



/*

 * API for receiving data from the Output port of a device.
@@ -149,14 +149,14 @@ ssize_t AMIDI_API AMidiDevice_getNumOutputPorts(const AMidiDevice *device); 
 *  @see AMEDIA_ERROR_UNKNOWN {@link AMEDIA_ERROR_UNKNOWN} - Unknown Error.

 */

media_status_t AMIDI_API AMidiOutputPort_open(const AMidiDevice *device, int32_t portNumber,

                             AMidiOutputPort **outOutputPortPtr);

                             AMidiOutputPort **outOutputPortPtr) __INTRODUCED_IN(29);



/**

 * Closes the output port.

 *

 * @param outputPort    The native API port identifier of the port.

 */

void AMIDI_API AMidiOutputPort_close(const AMidiOutputPort *outputPort);

void AMIDI_API AMidiOutputPort_close(const AMidiOutputPort *outputPort) __INTRODUCED_IN(29);



/**

 * Receives the next pending MIDI message. To retrieve all pending messages, the client should
@@ -177,7 +177,7 @@ void AMIDI_API AMidiOutputPort_close(const AMidiOutputPort *outputPort); 
 *  @see AMEDIA_ERROR_UNKNOWN {@link AMEDIA_ERROR_UNKNOWN} - Unknown Error.

 */

ssize_t AMIDI_API AMidiOutputPort_receive(const AMidiOutputPort *outputPort, int32_t *opcodePtr,

         uint8_t *buffer, size_t maxBytes, size_t* numBytesReceivedPtr, int64_t *outTimestampPtr);

         uint8_t *buffer, size_t maxBytes, size_t* numBytesReceivedPtr, int64_t *outTimestampPtr) __INTRODUCED_IN(29);



/*

 * API for sending data to the Input port of a device.
@@ -196,7 +196,7 @@ ssize_t AMIDI_API AMidiOutputPort_receive(const AMidiOutputPort *outputPort, int 
 *  @see AMEDIA_ERROR_UNKNOWN {@link AMEDIA_ERROR_UNKNOWN} - Unknown Error.

 */

media_status_t AMIDI_API AMidiInputPort_open(const AMidiDevice *device, int32_t portNumber,

                            AMidiInputPort **outInputPortPtr);

                            AMidiInputPort **outInputPortPtr) __INTRODUCED_IN(29);



/**

 * Sends data to the specified input port.
@@ -210,7 +210,7 @@ media_status_t AMIDI_API AMidiInputPort_open(const AMidiDevice *device, int32_t 
 *   was NULL, the specified buffer was NULL.

 */

ssize_t AMIDI_API AMidiInputPort_send(const AMidiInputPort *inputPort, const uint8_t *buffer,

                   size_t numBytes);

                   size_t numBytes) __INTRODUCED_IN(29);



/**

 * Sends data to the specified input port with a timestamp.
@@ -225,7 +225,7 @@ ssize_t AMIDI_API AMidiInputPort_send(const AMidiInputPort *inputPort, const uin 
 *   was NULL, the specified buffer was NULL.

 */

ssize_t AMIDI_API AMidiInputPort_sendWithTimestamp(const AMidiInputPort *inputPort,

        const uint8_t *buffer, size_t numBytes, int64_t timestamp);

        const uint8_t *buffer, size_t numBytes, int64_t timestamp) __INTRODUCED_IN(29);



/**

 * Sends a message with a 'MIDI flush command code' to the specified port. This should cause
@@ -239,14 +239,14 @@ ssize_t AMIDI_API AMidiInputPort_sendWithTimestamp(const AMidiInputPort *inputPo 
 * @see AMEDIA_ERROR_UNSUPPORTED {@link AMEDIA_ERROR_UNSUPPORTED} The FLUSH command couldn't

 * be sent.

 */

media_status_t AMIDI_API AMidiInputPort_sendFlush(const AMidiInputPort *inputPort);

media_status_t AMIDI_API AMidiInputPort_sendFlush(const AMidiInputPort *inputPort) __INTRODUCED_IN(29);



/**

 * Closes the input port.

 *

 * @param inputPort Identifies the input (sending) port to close.

 */

void AMIDI_API AMidiInputPort_close(const AMidiInputPort *inputPort);

void AMIDI_API AMidiInputPort_close(const AMidiInputPort *inputPort) __INTRODUCED_IN(29);



#ifdef __cplusplus

}