IOAudioDevice

Обсуждение

Как только IOAudioEngine был активирован этой функцией, это готово начать перемещать аудиоданные. Это нужно вызвать любым во время initHardware подкласса () реализацией для каждого IOAudioEngine, который создает устройство. Если бы аудио механизм автоматически создавался соответствием IOKIT процесса, или это должен вызвать сам IOAudioEngine. Система не будет в состоянии должным образом отследить и управлять IOAudioEngines, если они не будут активированы хотя эта функция. Эта реализация сохранит IOAudioEngine, в то время как это обеспечивает контроль над ним. Когда аудио механизм будет деактивирован, IOAudioEngine будет выпущен. Если подкласс IOAudioDevice передаст недавно инстанцированный IOAudioEngine, то он должен будет выпустить аудио механизм после того, как он был активирован. Это обеспечит, чтобы refCount на аудио механизме был корректен, когда это деактивировано, когда останавливается драйвер. Это позволяет аудио механизму быть освобожденным, когда он больше не необходим.

Обсуждение

Частота обратных вызовов события таймера будет самым маленьким интервалом, указанным всеми целями. Только один интервал и обратный вызов могут быть указаны на цель. Если addTimerEvent вызывают дважды с той же целью, второй переопределяет первое. Если первый вызов имел самый маленький интервал, в настоящее время существует ошибка, инициированная. В этом случае тот самый маленький интервал все еще использовался бы.

Обсуждение

Эта функция обеспечивает функциональность для представления сигнальной цепочки устройства в IOAudioPlane в IORegistry. Родитель (и) IOAudioPort, прежде чем это в сигнальной цепочке и ее дочерних элементах после него. Этот метод можно вызвать многократно для единственного IOAudioPort. Когда существует много дочерних элементов или родителей, это необходимо. Как только отношение сделано, не необходимо сделать обратное отношение. Значение Нулевого может быть передано в или для родителя или для дочернего элемента или обоих. IOAudioPort передал в, должен быть недавно выделенный экземпляр IOAudioPort. Эта функция соответственно присоединит и запустит объект порта.Примечание: Не необходимо использовать IOAudioPorts в полностью функциональном драйвере аудио.

Обсуждение

Это нужно только вызвать в то время как на IOWorkLoop. Это не предназначается, чтобы быть вызванным непосредственно. Это вызывают, когда IOAudioEngine запускает, чтобы позволить IOAudioDevice отслеживать рабочие аудио механизмы и изменять состояние электропитания от kIOAudioDeviceIdle до kIOAudioDeviceActive, когда первый аудио механизм запускает. Если изменение состояния сделано асинхронно, оно ожидает изменения состояния для завершения. Это должно гарантировать, что система не начинает играть аудио, пока IOAudioDevice не завершил свой переход к kIOAudioDeviceActive.

Обсуждение

Это нужно только вызвать в то время как на IOWorkLoop. Это не предназначается, чтобы быть вызванным непосредственно. Это вызывают, когда IOAudioEngine остановился, чтобы позволить IOAudioDevice отслеживать рабочие аудио механизмы и изменять состояние электропитания от kIOAudioDeviceActive до kIOAudioDeviceIdle, когда останавливается последний аудио механизм. Если изменение состояния сделано асинхронно, оно ожидает изменения состояния для завершения.

Обсуждение

В случае асинхронного изменения состояния электропитания подкласс ответственен за вызывание этой функции. Безопасно вызвать эту функцию если не на IOWorkLoop. Это вызовы функции protectedCompletePowerStateChange () через IOCommandGate и completePowerStateChangeAction (). Если вызов уже находится на IOWorkLoop, безопасно вызвать protectedCompletePowerStateChange () непосредственно.

Обсуждение

Это необходимо, чтобы позволить protectedCompletePowerStateChange () быть вызванным на IOWorkLoop.

Обсуждение

Это вызывает остановка () и свободное () методы в IOAudioDevice для завершенного закрытия всех аудио механизмов, поскольку закрывается драйвер.

Обсуждение

Это вызывает остановка () и свободное () методы в IOAudioDevice для завершенного закрытия всех портов, поскольку закрывается драйвер.

Обсуждение

Этот метод выполняет итерации через все событие таймера, предназначается и вызывает обратный вызов на каждом. Если флаг силы не будет установлен в истину, события таймера будут только диспетчеризированы, если состояние электропитания не будет kIOAudioDeviceSleep. Это предотвращает неожиданные взрывы таймера при создании следа-> сон-> переходы следа. Эта функция должна быть вызвана на IOWorkLoop.

Обсуждение

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

Обсуждение

Этот метод деактивирует все аудио аудио механизмы и выпустит audioEngines OSSet. Это также деактивирует все аудиопорты и выпустит аудиопорты OSSet. Это выпустит timerEvents OSDictionary, а также отменит любые выдающиеся обратные вызовы таймера. Это очистит все источники событий и workLoop.

Не вызывайте это непосредственно. Когда refcount экземпляра переходит в 0, это вызывает автоматически система. Постепенно уменьшать refcount, разъединение вызова () на объекте.

Обсуждение

Этот IOCommandGate позволяет вызовам в этот IOAudioDevice синхронизироваться на IOWorkLoop.

Обсуждение

IOWorkLoop привык к синхронизируемому все критические аспекты драйвера. Это включает все точки входа в драйвер, а также управление питанием.

Обсуждение

Эта реализация инициализирует все структуры данных и переменные, используемые IOAudioDevice. currentPowerState и pendingPowerState переменные установлены в kIOAudioDeviceIdle. Подкласс, переопределяющий этот метод, должен вызвать реализацию суперкласса.

Обсуждение

В типичной реализации драйвер был бы реализация эта функция, и выполните много задач. Те включают отображающиеся аппаратные ресурсы, инициализируя аппаратные средства к известному состоянию, создавая IOAudioEngines, IOAudioControls и IOAudioStreams. Дополнительно это должно также вызвать setDeviceName (), setDeviceShortName (), setManufacturerName (). По возврату этой функции устройство должно быть готово начать продавать службы к системе.

Обсуждение

Эта функция должна быть вызвана на IOWorkLoop. Это вызывает performPowerStateChange (), чтобы позволить драйверу обработать изменение состояния. Если изменение состояния завершается синхронно драйвером (подкласс), это вызывает protectedCompletePowerStateChange (). Если сделано асинхронно это возвращает microsecondsUntilComplete, установленный performPowerStateChange (). Эта функция не должна быть вызвана непосредственно.

Обсуждение

Для контакта с изменениями состояния электропитания подкласс должен переопределить эту функцию. Любая комбинация старых и новых состояний электропитания может быть передана этой функции. Если работа должна быть выполнена при переходе для сна проверьте на newPowerState kIOAudioDeviceSleep. Если работа должна быть выполнена при переходе от сна проверьте на oldPowerState kIOAudioDeviceSleep. Состояние электропитания kIOAudioDeviceIdle означает, что система бодрствует, но никакие клиенты в настоящее время не играют или записывают аудио (т.е. никакие IOAudioEngines не активны). Состояние электропитания kIOAudioDeviceActive означает, что по крайней мере один IOAudioEngine активен. Для изменения состояния электропитания возможно быть выполненным синхронно или асинхронно. В случае синхронного изменения состояния электропитания, простой отпуск microsecondsUntilComplete один и возврат kIOReturnSuccess. Если асинхронное изменение состояния электропитания необходимо, драйвер должен сделать любое необходимое для планирования другого потока, чтобы закончить изменение состояния и установить microsecondsUntilComplete в верхнюю границу на количестве времени, которое это займет для завершения изменения состояния электропитания. Тогда, когда изменение состояния электропитания завершено, вызов должен быть выполнен к completePowerStateChange (). Во время асинхронного изменения состояния электропитания текущее состояние электропитания останется тем же как, прежде чем переход начался, и pendingPowerState установлен в новое состояние электропитания, которое будет установлено, когда изменение будет завершено.

Обсуждение

Эта функция выполняет работу для завершения изменения состояния электропитания (и синхронный и асинхронный). Если система просыпается от сна, система таймера перезапущена, и аудио механизмы возобновляются. Если это вызвали в результате асинхронного состояния электропитания, измененного, оно выполняет вызов управления питанием IOService acknowledgePowerChange () и сбрасывает asyncPowerStateChangeInProgress переменную. Наконец это устанавливает currentPowerState в pendingPowerState. Эта функция должна быть вызвана на IOWorkLoop. Если подкласс не находится на IOWorkLoop (например, содержание IOCommandGate), вызовите completePowerStateChange () вместо этого.

Обсуждение

Когда система спит или просыпается, эта функция ответственна за выполнение необходимого сна и задач следа. Если выдающееся изменение состояния электропитания произойдет, то оно будет ожидать до изменений состояния завершился. При сне все аудио механизмы останавливаются прежде, чем вызвать initiatePowerStateChange () для вызова performPowerStateChange (), чтобы позволить драйверу иметь дело с запросом сна. При пробуждении это определяет, должно ли устройство быть неактивным или активным и продолжает вызывать initiatePowerStateChange (). Если initiatePowerStateChange () указывает, что изменение состояния электропитания происходит асинхронно, это возвращает число микросекунд. Эту функцию нужно вызвать на IOWorkLoop, но нельзя вызвать непосредственно.

Обсуждение

Вызванный во время разрушения драйвера

Обсуждение

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

Обсуждение

Это полезно для драйверов устройств, которые слишком сложны, чтобы быть представленными панелью Sound Preferences. ID пакета является более гибким способом указать, где приложение, чем твердый кодированный путь.

Обсуждение

Это полезно для драйверов устройств, не хотящих быть устройством по умолчанию. Может быть вызван с kIOAudioDeviceCanBeDefaultNothing, чтобы препятствовать тому, чтобы CoreAudio позволил этому устройству быть любым устройством по умолчанию, или это можно вызвать с любой комбинацией kIOAudioDeviceCanBeDefaultInput, kIOAudioDeviceCanBeDefaultOutput, или kIOAudioDeviceCanBeSystemOutput. Значение по умолчанию (kIOAudioDeviceCanBeDefaultInput | kIOAudioDeviceCanBeDefaultOutput | kIOAudioDeviceCanBeSystemOutput).

Обсуждение

Этот метод нужно вызвать во время инициализации или запуска. Это должно быть установлено, к этому времени initHardware () завершается. Имя устройства используется CoreAudio.framework для идентификации определенной части аппаратных средств. Эта строка должна, должен быть локализован драйвером.

Обсуждение

Краткое название является более коротким представлением имени устройства. Когда имя устройства является слишком длинным, это может использоваться приложениями. Это должно быть установлено, к этому времени initHardware () завершается. Строка должна быть локализована драйвером.

Обсуждение

Поведение по умолчанию для семьи для управления питанием. Только необходимо вызвать эту функцию, если драйвер не хочет, чтобы семья управляла питанием. Не рекомендуется, чтобы эта функция была вызвана, потому что это делает управление питанием намного более трудным для драйвера. Если эта функция должна быть вызвана, ее нужно вызвать, прежде initHardware () завершается. Сразу после initHardware () вызывается запуском (), система управления питанием инициализируется, если семья должна управлять питанием.

Обсуждение

Это полезно, если устройство захочет выключить свои аппаратные средства в неактивное состояние сна, но не хочет делать это, если аудио не использовалось некоторое время. Если неактивное отличается с предыдущего раза, вызывание этой функции сразу изменяет неактивный таймер автоматического отключения и ставит его в очередь. Значения по умолчанию времени простоя к 0, что означает быть сразу вызванным (назад совместимым с предыдущими версиями IOAudioFamily). Значение средних значений 0xffffffffffffffffULL никогда не говорит драйвер о движении неактивного.

Обсуждение

Этот метод нужно вызвать во время инициализации или запуска. Это нужно вызвать, к этому времени initHardware () завершается. Строка должна быть локализована драйвером.

Обсуждение

Реализация по умолчанию IOAudioDevice устанавливает два состояния электропитания для IOService для использования. Состояние 0 является сном, и состояние 1 является следом. Эта функция не должна быть вызвана непосредственно. Это, как только предполагается, используется службами управления питанием IOService.

Обсуждение

Это необходимо, чтобы позволить protectedSetPowerState () быть вызванным на IOWorkLoop

Обсуждение

Запуск () реализация в IOAudioDevice запускается путем вызова, запускаются () на ее суперклассе. Это тогда вызывает initHardware (), который подкласс должен переопределить для надлежащей инициализации себя и аппаратные средства. Если тот вызов успешно выполняется, он устанавливает управление питанием, если семья, как предполагается, управляет питанием (проверяющий familyManagePower переменную). Тогда наконец это вызывает registerService () для создания IOAudioDevice видимым в IORegistry.

Обсуждение

IOAudioDevice implentation остановки () отключает сервисы таймера, деактивировал все аудио аудио механизмы и аудиопорты и останавливает управление питанием устройства. Аудио деактивация механизма и порта заставляет все аудио механизмы быть остановленными и весь аудио механизм и ресурсы портов и объекты, которые будут выпущены. Реализация подкласса может, мог закрыть аппаратные средства здесь при необходимости. Если эта функция переопределяется подклассом, реализацию суперкласса нужно вызвать.

Обсуждение

Эта функция просто вызывает dispatchTimerEvents () на IOAudioDevice, чтобы сделать просто это.

Обсуждение

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