Ссылка установки MIDI

Наследование

Не применимый

Соответствует

Не применимый

Оператор импорта

Swift

import CoreMIDI

Objective C

@import CoreMIDI;

Функции, описанные в этом документе, позволяют Вам управлять и настроить глобальное состояние системы MIDI. Эти функции обычно необходимы только приложениями, хотящими позволить пользователю некоторую гибкость в том, как представлено состояние системы MIDI.

Функции

Прочие условия


    
    MIDIDeviceAddEntity (_: _: _: _: _: _:)
    MIDIDeviceAddEntity

Объявление

Swift

func MIDIDeviceAddEntity(_ device: MIDIDeviceRef, _ name: CFString!, _ embedded: Boolean, _ numSourceEndpoints: Int, _ numDestinationEndpoints: Int, _ newEntity: UnsafeMutablePointer<MIDIEntityRef>) -> OSStatus

Objective C

OSStatus MIDIDeviceAddEntity ( MIDIDeviceRef device, CFStringRef name, Boolean embedded, ItemCount numSourceEndpoints, ItemCount numDestinationEndpoints, MIDIEntityRef *newEntity );

Параметры

`device`	Устройство, к которому должен быть добавлен объект.
`name`	Имя нового объекта.
`embedded`	Истина, если этот объект в устройстве, ложь, если объект просто состоит из внешних коннекторов, к которым могут быть присоединены другие устройства.
`numSourceEndpoints`	Число исходных конечных точек объект имеет.
`numDestinationEndpoints`	Число целевых конечных точек объект имеет.
`newEntity`	По успешному возврату, точкам к недавно создаваемому объекту.

Возвращаемое значение

Код результата.

Обсуждение

Драйверы вызывают эту функцию для указания одного из объектов, включающих устройство.

Недрайверы могут вызвать эту функцию с CoreMIDI 1.1, для добавления объектов к внешним устройствам.

Оператор импорта

Objective C

@import CoreMIDI;

Swift

import CoreMIDI

Доступность

Доступный в iOS 4.2 и позже.


    
    MIDIDeviceRemoveEntity (_: _:)
    MIDIDeviceRemoveEntity

Объявление

Swift

func MIDIDeviceRemoveEntity(_ device: MIDIDeviceRef, _ entity: MIDIEntityRef) -> OSStatus

Objective C

OSStatus MIDIDeviceRemoveEntity ( MIDIDeviceRef device, MIDIEntityRef entity );

Параметры

`device`	Устройство, из которого должен быть удален объект.
`entity`	Объект, который будет удален.

Возвращаемое значение

Код результата.

Обсуждение

Драйверы могут вызвать эту функцию для удаления одного из объектов устройства.

Новый для CoreMIDI 1.1.

Оператор импорта

Objective C

@import CoreMIDI;

Swift

import CoreMIDI

Доступность

Доступный в iOS 4.2 и позже.


    
    MIDIEntityAddOrRemoveEndpoints (_: _: _:)
    MIDIEntityAddOrRemoveEndpoints

Объявление

Swift

func MIDIEntityAddOrRemoveEndpoints(_ entity: MIDIEntityRef, _ numSourceEndpoints: Int, _ numDestinationEndpoints: Int) -> OSStatus

Objective C

OSStatus MIDIEntityAddOrRemoveEndpoints ( MIDIEntityRef entity, ItemCount numSourceEndpoints, ItemCount numDestinationEndpoints );

Параметры

`entity`	Объект, конечными точками которого нужно управлять.
`numSourceEndpoints`	Желаемое новое число исходных конечных точек.
`numDestinationEndpoints`	Желаемое новое число целевых конечных точек.

Возвращаемое значение

Код результата.

Обсуждение

Драйверы и редакторы конфигураций могут вызвать эту функцию, чтобы добавить к или удалить конечные точки объекта.

Новый для CoreMIDI 1.3.

Оператор импорта

Objective C

@import CoreMIDI;

Swift

import CoreMIDI

Доступность

Доступный в iOS 4.2 и позже.


    
    MIDIExternalDeviceCreate (_: _: _: _:)
    MIDIExternalDeviceCreate

Создайте новое внешнее MIDI-устройство.

Объявление

Swift

func MIDIExternalDeviceCreate(_ name: CFString!, _ manufacturer: CFString!, _ model: CFString!, _ outDevice: UnsafeMutablePointer<MIDIDeviceRef>) -> OSStatus

Objective C

OSStatus MIDIExternalDeviceCreate ( CFStringRef name, CFStringRef manufacturer, CFStringRef model, MIDIDeviceRef *outDevice );

Параметры

`name`	Имя нового устройства.
`manufacturer`	Имя производителя устройства.
`model`	Имя модели устройства.
`outDevice`	По успешному возврату, точкам к недавно создаваемому устройству.

Возвращаемое значение

Код результата.

Обсуждение

Недрайверы могут вызвать эту функцию с CoreMIDI 1.1, для создания внешних устройств.

Новое устройство не добавляется к текущему MIDISetupRef; чтобы сделать это, используйте MIDISetupAddExternalDevice.

Оператор импорта

Objective C

@import CoreMIDI;

Swift

import CoreMIDI

Доступность

Доступный в iOS 4.2 и позже.

MIDISetupAddDevice (_:) MIDISetupAddDevice

Добавляет MIDI-устройство владельца драйвера к текущему MIDISetup

Объявление

Swift

func MIDISetupAddDevice(_ device: MIDIDeviceRef) -> OSStatus

Objective C

OSStatus MIDISetupAddDevice ( MIDIDeviceRef device );

Параметры

device

Устройство, которое будет добавлено.

Обсуждение

Только драйверы MIDI могут выполнить этот вызов; это находится в этом заголовочном файле только для непротиворечивости с MIDISetupRemoveDevice.

Новый для CoreMIDI 1.1.

Оператор импорта

Objective C

@import CoreMIDI;

Swift

import CoreMIDI

Доступность

Доступный в iOS 4.2 и позже.
MIDISetupAddExternalDevice (_:) MIDISetupAddExternalDevice

Добавляет внешнее MIDI-устройство к текущему MIDISetup

Объявление

Swift

func MIDISetupAddExternalDevice(_ device: MIDIDeviceRef) -> OSStatus

Objective C

OSStatus MIDISetupAddExternalDevice ( MIDIDeviceRef device );

Параметры

device

Устройство, которое будет добавлено.

Обсуждение

Полезный для студийного редактора конфигураций. Новый для CoreMIDI 1.1.

Оператор импорта

Objective C

@import CoreMIDI;

Swift

import CoreMIDI

Доступность

Доступный в iOS 4.2 и позже.
MIDISetupRemoveDevice (_:) MIDISetupRemoveDevice

Удаляет MIDI-устройство находившееся в собственности драйвера из текущего MIDISetup

Объявление

Swift

func MIDISetupRemoveDevice(_ device: MIDIDeviceRef) -> OSStatus

Objective C

OSStatus MIDISetupRemoveDevice ( MIDIDeviceRef device );

Параметры

device

Устройство, которое будет добавлено.

Обсуждение

Обычно это нужно только вызвать от студийного редактора конфигураций, для удаления устройства, которое является оффлайновым и которое пользователь указал как являющийся постоянно недостающим.

Вместо того, чтобы удалить устройства из установки, драйверы должны установить kMIDIPropertyOffline устройства в 1 так, чтобы, если устройство вновь появляется позже, ни одно из его свойств не было потеряно.

Новый для CoreMIDI 1.1.

Оператор импорта

Objective C

@import CoreMIDI;

Swift

import CoreMIDI

Доступность

Доступный в iOS 4.2 и позже.
MIDISetupRemoveExternalDevice (_:) MIDISetupRemoveExternalDevice

Удаляет внешнее MIDI-устройство из текущего MIDISetup

Объявление

Swift

func MIDISetupRemoveExternalDevice(_ device: MIDIDeviceRef) -> OSStatus

Objective C

OSStatus MIDISetupRemoveExternalDevice ( MIDIDeviceRef device );

Параметры

device

Устройство, которое будет удалено.

Обсуждение

Полезный для студийного редактора конфигураций. Новый для CoreMIDI 1.1.

Оператор импорта

Objective C

@import CoreMIDI;

Swift

import CoreMIDI

Доступность

Доступный в iOS 4.2 и позже.

Типы данных

MIDISetupRef

Глобальное состояние системы MIDI, включая списки MIDI-устройств и владельцев последовательного порта.

Объявление

Swift

typealias MIDISetupRef = COpaquePointer

Objective C

#if __LP64__ typedef MIDIObjectRef MIDISetupRef; #else typedef struct OpaqueMIDISetup *MIDISetupRef; #endif

Обсуждение

Происходит из MIDIObjectRef, не сделал, чтобы возразил владелец.

Сервер MIDI поддерживает единственный глобальный объект MIDISetupRef, хранившийся постоянно в предпочтительном файле. Только специализированные редакторы конфигураций — не типичные приложения MIDI — должны управлять объектами установки MIDI.

Оператор импорта

Objective C

@import CoreMIDI;

Swift

import CoreMIDI

Доступность

Доступный в iOS 4.2 и позже.