Android/frameworks_base
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

am 854829de: am 4f84e648: am 6bf9b8ca: am 559a2420: Merge "MidiDevice: document that opens can return nulls" into mnc-dev

Browse Source 
* commit '854829deeca86a851ffd2a8f0eec3d11ffd266bc':
  MidiDevice: document that opens can return nulls
This commit is contained in:
Phil Burk
2015-07-30 22:02:54 +00:00
committed by Android Git Automerger
parent 3c01ac0b19 854829deec
commit 3674e1f701
1 changed files with 10 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

12
media/java/android/media/midi/MidiDevice.java
View File

@@ -113,8 +113,13 @@ public final class MidiDevice implements Closeable {
/** /**
* Called to open a {@link MidiInputPort} for the specified port number. * Called to open a {@link MidiInputPort} for the specified port number.
* *
* An input port can only be used by one sender at a time.
* Opening an input port will fail if another application has already opened it for use.
* A {@link MidiDeviceStatus} can be used to determine if an input port is already open.
*
* @param portNumber the number of the input port to open * @param portNumber the number of the input port to open
* @return the {@link MidiInputPort} * @return the {@link MidiInputPort} if the open is successful,
* or null in case of failure.
*/ */
public MidiInputPort openInputPort(int portNumber) { public MidiInputPort openInputPort(int portNumber) {
try { try {
@@ -133,8 +138,11 @@ public final class MidiDevice implements Closeable {
/** /**
* Called to open a {@link MidiOutputPort} for the specified port number. * Called to open a {@link MidiOutputPort} for the specified port number.
* *
* An output port may be opened by multiple applications.
*
* @param portNumber the number of the output port to open * @param portNumber the number of the output port to open
* @return the {@link MidiOutputPort} * @return the {@link MidiOutputPort} if the open is successful,
* or null in case of failure.
*/ */
public MidiOutputPort openOutputPort(int portNumber) { public MidiOutputPort openOutputPort(int portNumber) {
try { try {