Аудио аппаратная ссылка служб

Этот документ описывает Audio Hardware Services, легкий интерфейс C для простых взаимодействий с аудио аппаратными средствами в OS X.

Существует другой аппаратный интерфейс с дополнительными функциями, известными как Аудио Уровень аппаратной абстракции или Аудио HAL. Тот интерфейс объявляется в AudioHardware.h заголовочный файл в платформе Core Audio.

Интерфейс, описанный в этом документе, взаимодействует с объектами аудио HAL, объявленными в AudioHardware.h.

Функции

Взаимодействие с аудио аппаратными средствами


    
    AudioHardwareServiceAddPropertyListener (_: _: _: _:)
    AudioHardwareServiceAddPropertyListener

Регистрирует функцию обратного вызова слушателя свойства объекта аудио HAL, которая будет вызвана, когда изменяется указанное свойство.

Объявление

Swift

func AudioHardwareServiceAddPropertyListener(_ inObjectID: AudioObjectID, _ inAddress: UnsafePointer<AudioObjectPropertyAddress>, _ inListener: AudioObjectPropertyListenerProc, _ inClientData: UnsafeMutablePointer<Void>) -> OSStatus

Objective C

OSStatus AudioHardwareServiceAddPropertyListener ( AudioObjectID inObjectID, const AudioObjectPropertyAddress *inAddress, AudioObjectPropertyListenerProc inListener, void *inClientData );

Параметры

`inObjectID`	Аудио HAL возражает для регистрации функции обратного вызова слушателя в.
`inAddress`	Свойство, когда изменено, инициировавшее вызов к Вашей функции обратного вызова слушателя.
`inListener`	он обратный вызов слушателя свойства для регистрации.
`inClientData`	Данные приложения, передающиеся Вашему обратному вызову слушателя, когда это вызывается.

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

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

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

Objective C

@import AudioToolbox;

Swift

import AudioToolbox

Доступность

Доступный в OS X v10.5 и позже.

См. также

AudioHardwareServiceRemovePropertyListener


    
    AudioHardwareServiceGetPropertyData (_: _: _: _: _: _:)
    AudioHardwareServiceGetPropertyData

Получает значение для указанного свойства.

Объявление

Swift

func AudioHardwareServiceGetPropertyData(_ inObjectID: AudioObjectID, _ inAddress: UnsafePointer<AudioObjectPropertyAddress>, _ inQualifierDataSize: UInt32, _ inQualifierData: UnsafePointer<Void>, _ ioDataSize: UnsafeMutablePointer<UInt32>, _ outData: UnsafeMutablePointer<Void>) -> OSStatus

Objective C

OSStatus AudioHardwareServiceGetPropertyData ( AudioObjectID inObjectID, const AudioObjectPropertyAddress *inAddress, UInt32 inQualifierDataSize, const void *inQualifierData, UInt32 *ioDataSize, void *outData );

Параметры

`inObjectID`	Аудио HAL возражает для запросов.
`inAddress`	Свойство, значение которого Вы хотите.
`inQualifierDataSize`	A `UInt32` значение, указывающее размер буфера, на который указывают `inQualifierData` параметр. Не все свойства требуют квалификации; в таком случае Вы устанавливаете этот параметр на `0`.
`inQualifierData`	Буфер данных, которые будут использоваться в определении значения запрашиваемого свойства. Не все свойства требуют квалификации; в таком случае Вы устанавливаете этот параметр на `NULL`.
`ioDataSize`	На вводе, a `UInt32` значение, указывающее размер, в байтах, буфера, на который указывают `outData` параметр. На выходе размер использовавшегося буфера.
`outData`	Буфер, в который объект аудио HAL поместит значение свойства.

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

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

Специальные замечания

Некоторые значения свойств Core Audio являются типами C, и другие являются Базовыми объектами Основы.

Если Вы вызываете эту функцию для получения значения, которое является Базовым объектом Основы, то эта функция — несмотря на использование «Get» на его имя — копирует объект. Вы ответственны за выпуск объекта, как описано в Создать Правиле в Руководстве по программированию управления памятью для Базовой Основы.

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

Objective C

@import AudioToolbox;

Swift

import AudioToolbox

Доступность

Доступный в OS X v10.5 и позже.

См. также

AudioHardwareServiceGetPropertyDataSize


    
    AudioHardwareServiceGetPropertyDataSize (_: _: _: _: _:)
    AudioHardwareServiceGetPropertyDataSize

Получает размер полезной нагрузки для данного свойства.

Объявление

Swift

func AudioHardwareServiceGetPropertyDataSize(_ inObjectID: AudioObjectID, _ inAddress: UnsafePointer<AudioObjectPropertyAddress>, _ inQualifierDataSize: UInt32, _ inQualifierData: UnsafePointer<Void>, _ outDataSize: UnsafeMutablePointer<UInt32>) -> OSStatus

Objective C

OSStatus AudioHardwareServiceGetPropertyDataSize ( AudioObjectID inObjectID, const AudioObjectPropertyAddress *inAddress, UInt32 inQualifierDataSize, const void *inQualifierData, UInt32 *outDataSize );

Параметры

`inObjectID`	Аудио HAL возражает для запросов.
`inAddress`	Свойство, размер полезной нагрузки которого Вы хотите.
`inQualifierDataSize`	A `UInt32` значение, указывающее размер буфера, на который указывают `inQualifierData` параметр. Не все свойства требуют квалификации; в таком случае Вы устанавливаете этот параметр на `0`.
`inQualifierData`	Буфер данных, которые будут использоваться в определении значения запрашиваемого свойства. Не все свойства требуют квалификации; в таком случае Вы устанавливаете этот параметр на `NULL`.
`outDataSize`	A `UInt32` значение, указывающее размер, в байтах, полезной нагрузки для данного свойства.

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

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

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

Objective C

@import AudioToolbox;

Swift

import AudioToolbox

Доступность

Доступный в OS X v10.5 и позже.

См. также

AudioHardwareServiceGetPropertyData


    
    AudioHardwareServiceHasProperty (_: _:)
    AudioHardwareServiceHasProperty

Запрашивает объект аудио HAL о том, имеет ли он указанное свойство.

Объявление

Swift

func AudioHardwareServiceHasProperty(_ inObjectID: AudioObjectID, _ inAddress: UnsafePointer<AudioObjectPropertyAddress>) -> Boolean

Objective C

Boolean AudioHardwareServiceHasProperty ( AudioObjectID inObjectID, const AudioObjectPropertyAddress *inAddress );

Параметры

`inObjectID`	Аудио HAL возражает для запросов.
`inAddress`	Свойство, о котором Вы спрашиваете.

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

Булево значение, указывающее, имеет ли объект аудио HAL действительно свойство (true) или не (false).

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

Objective C

@import AudioToolbox;

Swift

import AudioToolbox

Доступность

Доступный в OS X v10.5 и позже.

См. также

AudioHardwareServiceIsPropertySettable


    
    AudioHardwareServiceIsPropertySettable (_: _: _:)
    AudioHardwareServiceIsPropertySettable

Запрашивает объект аудио HAL о том, устанавливаемо ли указанное свойство.

Объявление

Swift

func AudioHardwareServiceIsPropertySettable(_ inObjectID: AudioObjectID, _ inAddress: UnsafePointer<AudioObjectPropertyAddress>, _ outIsSettable: UnsafeMutablePointer<Boolean>) -> OSStatus

Objective C

OSStatus AudioHardwareServiceIsPropertySettable ( AudioObjectID inObjectID, const AudioObjectPropertyAddress *inAddress, Boolean *outIsSettable );

Параметры

`inObjectID`	Аудио HAL возражает для запросов.
`inAddress`	Свойство, о котором Вы спрашиваете.
`outIsSettable`	Булево значение, указывающее, устанавливаемо ли свойство (`true`) или не (`false`).

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

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

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

Objective C

@import AudioToolbox;

Swift

import AudioToolbox

Доступность

Доступный в OS X v10.5 и позже.

См. также

AudioHardwareServiceHasProperty
AudioHardwareServiceSetPropertyData


    
    AudioHardwareServiceRemovePropertyListener (_: _: _: _:)
    AudioHardwareServiceRemovePropertyListener

Не регистрирует функцию обратного вызова слушателя свойства объекта аудио HAL.

Объявление

Swift

func AudioHardwareServiceRemovePropertyListener(_ inObjectID: AudioObjectID, _ inAddress: UnsafePointer<AudioObjectPropertyAddress>, _ inListener: AudioObjectPropertyListenerProc, _ inClientData: UnsafeMutablePointer<Void>) -> OSStatus

Objective C

OSStatus AudioHardwareServiceRemovePropertyListener ( AudioObjectID inObjectID, const AudioObjectPropertyAddress *inAddress, AudioObjectPropertyListenerProc inListener, void *inClientData );

Параметры

`inObjectID`	Аудио HAL возражает, чтобы не зарегистрировать функцию обратного вызова слушателя от.
`inAddress`	Свойство Вы больше не хотите уведомления о.
`inListener`	Функция обратного вызова слушателя свойства Вы удаляете.
`inClientData`	Данные приложения Вы указали при регистрации функции обратного вызова.

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

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

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

Objective C

@import AudioToolbox;

Swift

import AudioToolbox

Доступность

Доступный в OS X v10.5 и позже.

См. также

AudioHardwareServiceAddPropertyListener


    
    AudioHardwareServiceSetPropertyData (_: _: _: _: _: _:)
    AudioHardwareServiceSetPropertyData

Спрашивает объект аудио HAL изменить значение указанного свойства.

Объявление

Swift

func AudioHardwareServiceSetPropertyData(_ inObjectID: AudioObjectID, _ inAddress: UnsafePointer<AudioObjectPropertyAddress>, _ inQualifierDataSize: UInt32, _ inQualifierData: UnsafePointer<Void>, _ inDataSize: UInt32, _ inData: UnsafePointer<Void>) -> OSStatus

Objective C

OSStatus AudioHardwareServiceSetPropertyData ( AudioObjectID inObjectID, const AudioObjectPropertyAddress *inAddress, UInt32 inQualifierDataSize, const void *inQualifierData, UInt32 inDataSize, const void *inData );

Параметры

`inObjectID`	Аудио HAL возражает для установки значения свойства на.
`inAddress`	Свойство для установки.
`inQualifierDataSize`	A `UInt32` значение, указывающее размер буфера, на который указывают `inQualifierData` параметр. Не все свойства требуют квалификации; в таком случае Вы устанавливаете этот параметр на `0`.
`inQualifierData`	Буфер данных, которые будут использоваться в определении значения запрашиваемого свойства. Не все свойства требуют квалификации; в таком случае Вы устанавливаете этот параметр на `NULL`.
`inDataSize`	A `UInt32` значение, указывающее размер буфера, на который указывают `inData` параметр.
`inData`	Буфер, содержащий данные, которые будут использоваться в качестве нового значения свойства.

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

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

Обсуждение

Свойство нельзя считать измененным, пока HAL не вызвал Ваш обратный вызов слушателя свойства. Много свойств объектов аудио HAL изменяются асинхронно.

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

Objective C

@import AudioToolbox;

Swift

import AudioToolbox

Доступность

Доступный в OS X v10.5 и позже.

См. также

AudioHardwareServiceHasProperty
AudioHardwareServiceIsPropertySettable

Константы

Аудио аппаратные свойства служб
Идентификаторы свойства, применяющиеся к объектам аудио HAL только, когда получено доступ через Audio Hardware Services.

Объявление

Swift

var kAudioHardwareServiceProperty_ServiceRestarted: Int { get } var kAudioHardwareServiceDeviceProperty_VirtualMasterVolume: Int { get } var kAudioHardwareServiceDeviceProperty_VirtualMasterBalance: Int { get }

Objective C

enum { kAudioHardwareServiceProperty_ServiceRestarted = 'srst', kAudioHardwareServiceDeviceProperty_VirtualMasterVolume = 'vmvc', kAudioHardwareServiceDeviceProperty_VirtualMasterBalance = 'vmbc' };

Константы
- kAudioHardwareServiceProperty_ServiceRestarted
  
  kAudioHardwareServiceProperty_ServiceRestarted
  
  Используемый, с обратным вызовом слушателя свойства объекта аудио HAL, как флаг, указывающий аппаратный перезапуск службы. Свойство Float32 значение не имеет никакого значения. Когда аппаратная служба перезапускает, любое связанное состояние приложения, такое как кэшированные данные или обратные вызовы слушателя свойства, должно быть восстановлено.
  
  Доступный в OS X v10.5 и позже.
- kAudioHardwareServiceDeviceProperty_VirtualMasterVolume
  
  kAudioHardwareServiceDeviceProperty_VirtualMasterVolume
  
  A Float32 значение, представляющее значение регулятора громкости.
  
  Диапазон для значения этого свойства 0.0 (тишина) через 1.0 (полный уровень). Эффект этого свойства зависит от устройства, связанного с объектом аудио HAL. Если устройство имеет контроль общей громкостью, это свойство управляет им. Если устройство имеет регуляторы громкости отдельного канала, это свойство применяется к идентифицированным предпочтительным многоканальным расположением устройства или предпочтительной стереопарой, если устройство является стерео только. Это управление сохраняет относительный равновесие между каналами, на которые это влияет.
  
  Доступный в OS X v10.5 и позже.
- kAudioHardwareServiceDeviceProperty_VirtualMasterBalance
  
  kAudioHardwareServiceDeviceProperty_VirtualMasterBalance
  
  A Float32 значение, представляющее значение управления стереобалансом устройства.
  
  Диапазон для значения этого свойства 0.0 (полный оставленный) через 1.0 (полное право). Значение 0.5 средние значения, что оба канала стереопары по умолчанию имеют равное питание. Это управление доступно только для устройств, имеющих регуляторы громкости отдельного канала.
  
  Доступный в OS X v10.5 и позже.