# SOME DESCRIPTIVE TITLE
# Copyright (C) YEAR The FreeBSD Project
# This file is distributed under the same license as the FreeBSD Documentation package.
# Vladlen Popolitov <vladlenpopolitov@list.ru>, 2025.
msgid ""
msgstr ""
"Project-Id-Version: FreeBSD Documentation VERSION\n"
"POT-Creation-Date: 2025-11-08 16:17+0000\n"
"PO-Revision-Date: 2025-11-12 04:45+0000\n"
"Last-Translator: Vladlen Popolitov <vladlenpopolitov@list.ru>\n"
"Language-Team: Russian <https://translate-dev.freebsd.org/projects/"
"documentation/booksarch-handbooksound_index/ru/>\n"
"Language: ru\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Plural-Forms: nplurals=3; plural=n%10==1 && n%100!=11 ? 0 : n%10>=2 && "
"n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2;\n"
"X-Generator: Weblate 4.17\n"

#. type: YAML Front Matter: description
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:1
#, no-wrap
msgid "FreeBSD Sound Subsystem"
msgstr "Звуковая подсистема FreeBSD"

#. type: YAML Front Matter: title
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:1
#, no-wrap
msgid "Chapter 15. Sound Subsystem"
msgstr "Глава 15. Звуковая подсистема"

#. type: Title =
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:14
#, no-wrap
msgid "Sound Subsystem"
msgstr "Звуковая подсистема"

#. type: Title ==
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:52
#, no-wrap
msgid "Introduction"
msgstr "Введение"

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:55
msgid ""
"The FreeBSD sound subsystem cleanly separates generic sound handling issues "
"from device-specific ones. This makes it easier to add support for new "
"hardware."
msgstr ""
"Подсистема звука FreeBSD чётко разделяет общие вопросы обработки звука и "
"детали, специфичные для устройств. Это упрощает добавление поддержки нового "
"оборудования."

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:57
msgid ""
"The man:pcm[4] framework is the central piece of the sound subsystem. It "
"mainly implements the following elements:"
msgstr ""
"man:pcm[4] — это центральный компонент подсистемы звука. В основном он "
"реализует следующие элементы:"

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:59
msgid ""
"A system call interface (read, write, ioctls) to digitized sound and mixer "
"functions. The ioctl command set is compatible with the legacy _OSS_ or "
"_Voxware_ interface, allowing common multimedia applications to be ported "
"without modification."
msgstr ""
"Интерфейс системных вызовов (read, write, ioctls) для работы с оцифрованным "
"звуком и функциями микшера. Набор команд ioctl совместим с устаревшим "
"интерфейсом _OSS_ или _Voxware_, что позволяет портировать распространённые "
"мультимедийные приложения без изменений."

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:60
msgid ""
"Common code for processing sound data (format conversions, virtual channels)."
msgstr ""
"Общий код для обработки звуковых данных (преобразование форматов, "
"виртуальные каналы)."

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:61
msgid ""
"A uniform software interface to hardware-specific audio interface modules."
msgstr ""
"Единый программный интерфейс к аппаратно-зависимым модулям аудиоинтерфейсов."

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:62
msgid ""
"Additional support for some common hardware interfaces (ac97), or shared "
"hardware-specific code (ex: ISA DMA routines)."
msgstr ""
"Дополнительная поддержка некоторых распространённых аппаратных интерфейсов "
"(ac97) или общий код для специфичного оборудования (например: подпрограммы "
"ISA DMA)."

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:64
msgid ""
"The support for specific sound cards is implemented by hardware-specific "
"drivers, which provide channel and mixer interfaces to plug into the generic "
"[.filename]#pcm# code."
msgstr ""
"Поддержка конкретных звуковых карт реализована аппаратно-специфичными "
"драйверами, которые предоставляют интерфейсы каналов и микшера для "
"подключения к общему коду [.filename]#pcm#."

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:66
msgid ""
"In this chapter, the term [.filename]#pcm# will refer to the central, common "
"part of the sound driver, as opposed to the hardware-specific modules."
msgstr ""
"В этой главе термин [.filename]#pcm# будет относиться к центральной, общей "
"части звукового драйвера, в отличие от аппаратно-зависимых модулей."

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:68
msgid ""
"The prospective driver writer will of course want to start from an existing "
"module and use the code as the ultimate reference. But, while the sound code "
"is nice and clean, it is also mostly devoid of comments. This document tries "
"to give an overview of the framework interface and answer some questions "
"that may arise while adapting the existing code."
msgstr ""
"Разработчик драйверов, только начинающий свою разработку, конечно, захочет "
"начать с существующего модуля и использовать его код в качестве основного "
"источника информации. Однако, хотя код подсистемы звука чист и аккуратен, он "
"в основном лишён комментариев. Этот документ пытается дать обзор интерфейса "
"фреймворка и ответить на некоторые вопросы, которые могут возникнуть при "
"адаптации существующего кода."

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:70
msgid ""
"As an alternative, or in addition to starting from a working example, you "
"can find a commented driver template at https://people.FreeBSD.org/~cg/"
"template.c[ https://people.FreeBSD.org/~cg/template.c]"
msgstr ""
"В качестве альтернативы или в дополнение к началу разработки с примера "
"драйвера из кода системы, вы можете найти шаблон драйвера с комментариями по "
"адресу https://people.FreeBSD.org/~cg/template.c[ https://people.FreeBSD.org/"
"~cg/template.c]"

#. type: Title ==
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:72
#, no-wrap
msgid "Files"
msgstr "Файлы"

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:75
msgid ""
"All the relevant code lives in [.filename]#/usr/src/sys/dev/sound/#, except "
"for the public ioctl interface definitions, found in [.filename]#/usr/src/"
"sys/sys/soundcard.h#"
msgstr ""
"Весь соответствующий код находится в [.filename]#/usr/src/sys/dev/sound/#, "
"за исключением определений публичного интерфейса ioctl, которые можно найти "
"в [.filename]#/usr/src/sys/sys/soundcard.h#"

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:77
msgid ""
"Under [.filename]#/usr/src/sys/dev/sound/#, the [.filename]#pcm/# directory "
"holds the central code, while the [.filename]#pci/#, [.filename]#isa/# and [."
"filename]#usb/# directories have the drivers for PCI and ISA boards, and for "
"USB audio devices."
msgstr ""
"В каталоге [.filename]#/usr/src/sys/dev/sound/#, папка [.filename]#pcm/# "
"содержит основной код, тогда как каталоги [.filename]#pci/#, [.filename]#isa/"
"# и [.filename]#usb/# содержат драйверы для плат PCI и ISA, а также для USB-"
"аудиоустройств."

#. type: Title ==
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:79
#, no-wrap
msgid "Probing, Attaching, etc."
msgstr "Обнаружение, подключение и т.д."

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:82
msgid ""
"Sound drivers probe and attach in almost the same way as any hardware driver "
"module. You might want to look at the crossref:isa-driver[isa-driver,ISA] or "
"crossref:pci[pci,PCI] specific sections of the handbook for more information."
msgstr ""
"Драйверы звуковых устройств выполняют обнаружение и подключение почти так "
"же, как и любой модуль драйвера оборудования. Возможно, вам будет полезно "
"ознакомиться с разделами руководства, посвящёнными crossref:isa-driver[isa-"
"driver,ISA] или crossref:pci[pci,PCI], для получения дополнительной "
"информации."

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:84
msgid "However, sound drivers differ in some ways:"
msgstr "Однако драйверы звука отличаются в некоторых аспектах:"

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:86
msgid ""
"They declare themselves as [.filename]#pcm# class devices, with a `struct "
"snddev_info` device private structure:"
msgstr ""
"Они объявляют себя как устройства класса [.filename]#pcm#, с приватной "
"структурой устройства `struct snddev_info`:"

#. type: delimited block . 4
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:94
#, no-wrap
msgid ""
"          static driver_t xxx_driver = {\n"
"              \"pcm\",\n"
"              xxx_methods,\n"
"              sizeof(struct snddev_info)\n"
"          };\n"
msgstr ""
"          static driver_t xxx_driver = {\n"
"              \"pcm\",\n"
"              xxx_methods,\n"
"              sizeof(struct snddev_info)\n"
"          };\n"

#. type: delimited block . 4
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:97
#, no-wrap
msgid ""
"          DRIVER_MODULE(snd_xxxpci, pci, xxx_driver, pcm_devclass, 0, 0);\n"
"          MODULE_DEPEND(snd_xxxpci, snd_pcm, PCM_MINVER, PCM_PREFVER,PCM_MAXVER);\n"
msgstr ""
"          DRIVER_MODULE(snd_xxxpci, pci, xxx_driver, pcm_devclass, 0, 0);\n"
"          MODULE_DEPEND(snd_xxxpci, snd_pcm, PCM_MINVER, PCM_PREFVER,PCM_MAXVER);\n"

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:100
msgid ""
"Most sound drivers need to store additional private information about their "
"device. A private data structure is usually allocated in the attach routine. "
"Its address is passed to [.filename]#pcm# by the calls to `pcm_register()` "
"and `mixer_init()`. [.filename]#pcm# later passes back this address as a "
"parameter in calls to the sound driver interfaces."
msgstr ""
"Большинству звуковых драйверов необходимо хранить дополнительную приватную "
"информацию о своём устройстве. Приватная структура данных обычно выделяется "
"в процедуре подключения (attach). Её адрес передаётся в [.filename]#pcm# "
"через вызовы `pcm_register()` и `mixer_init()`. [.filename]#pcm# позже "
"передаёт обратно этот адрес в качестве параметра при вызовах интерфейсов "
"звукового драйвера."

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:103
msgid ""
"The sound driver attach routine should declare its MIXER or AC97 interface "
"to [.filename]#pcm# by calling `mixer_init()`. For a MIXER interface, this "
"causes in turn a call to crossref:sound[xxxmixer-init,`xxxmixer_init()`]."
msgstr ""
"Процедура подключения (attach) звукового драйвера должна объявить свой "
"интерфейс MIXER или AC97 для [.filename]#pcm#, вызвав `mixer_init()`. Для "
"интерфейса MIXER это, в свою очередь, приводит к вызову crossref:"
"sound[xxxmixer-init,`xxxmixer_init()`]."

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:104
msgid ""
"The sound driver attach routine declares its general CHANNEL configuration "
"to [.filename]#pcm# by calling `pcm_register(dev, sc, nplay, nrec)`, where "
"`sc` is the address for the device data structure, used in further calls "
"from [.filename]#pcm#, and `nplay` and `nrec` are the number of play and "
"record channels."
msgstr ""
"Процедура подключения драйвера звука объявляет свою общую конфигурацию "
"CHANNEL для [.filename]#pcm#, вызывая `pcm_register(dev, sc, nplay, nrec)`, "
"где `sc` — это адрес структуры данных устройства, используемый при "
"последующих вызовах из [.filename]#pcm#, а `nplay` и `nrec` — количество "
"каналов воспроизведения и записи."

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:107
msgid ""
"The sound driver attach routine declares each of its channel objects by "
"calls to `pcm_addchan()`. This sets up the channel glue in [.filename]#pcm# "
"and causes in turn a call to crossref:sound[xxxchannel-init,"
"`xxxchannel_init()`]."
msgstr ""
"Подпрограмма подключения звукового драйвера объявляет каждый из своих "
"каналов вызовами `pcm_addchan()`. Это настраивает связующий слой канала в [."
"filename]#pcm# и, в свою очередь, вызывает вызов crossref:sound[xxxchannel-"
"init,`xxxchannel_init()`]."

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:108
msgid ""
"The sound driver detach routine should call `pcm_unregister()` before "
"releasing its resources."
msgstr ""
"Драйвер звука должен вызвать `pcm_unregister()` в процедуре отключения "
"(detach) перед освобождением своих ресурсов."

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:110
msgid "There are two possible methods to handle non-PnP devices:"
msgstr ""
"Существует два возможных способа работы с устройствами, не поддерживающими "
"PnP:"

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:112
msgid ""
"Use a `device_identify()` method (example: [.filename]#sound/isa/es1888.c#). "
"The `device_identify()` method probes for the hardware at known addresses "
"and, if it finds a supported device, creates a new pcm device which is then "
"passed to probe/attach."
msgstr ""
"Используйте метод `device_identify()` (пример: [.filename]#sound/isa/es1888."
"c#). Метод `device_identify()` проверяет наличие оборудования по известным "
"адресам и, если находит поддерживаемое устройство, создает новое pcm-"
"устройство, которое затем передаётся для probe/attach."

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:113
msgid ""
"Use a custom kernel configuration with appropriate hints for pcm devices "
"(example: [.filename]#sound/isa/mss.c#)."
msgstr ""
"Используйте пользовательскую конфигурацию ядра с соответствующими "
"подсказками для устройств pcm (пример: [.filename]#sound/isa/mss.c#)."

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:115
msgid ""
"[.filename]#pcm# drivers should implement `device_suspend`, `device_resume` "
"and `device_shutdown` routines, so that power management and module "
"unloading function correctly."
msgstr ""
"[.filename]#pcm# драйверы должны реализовывать подпрограммы "
"`device_suspend`, `device_resume` и `device_shutdown`, чтобы управление "
"питанием и выгрузка модулей работали корректно."

#. type: Title ==
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:117
#, no-wrap
msgid "Interfaces"
msgstr "Интерфейсы"

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:121
msgid ""
"The interface between the [.filename]#pcm# core and the sound drivers is "
"defined in terms of crossref:kobj[kernel-objects,kernel objects]."
msgstr ""
"Интерфейс между ядром [.filename]#pcm# и звуковыми драйверами определяется в "
"терминах crossref:kobj[kernel-objects,объектов ядра Kobj]."

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:123
msgid ""
"There are two main interfaces that a sound driver will usually provide: "
"_CHANNEL_ and either _MIXER_ or _AC97_."
msgstr ""
"Существует два основных интерфейса, которые обычно предоставляет драйвер "
"звука: _CHANNEL_ и либо _MIXER_, либо _AC97_."

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:125
msgid ""
"The _AC97_ interface is a very small hardware access (register read/write) "
"interface, implemented by drivers for hardware with an AC97 codec. In this "
"case, the actual MIXER interface is provided by the shared AC97 code in [."
"filename]#pcm#."
msgstr ""
"Интерфейс _AC97_ — это очень небольшой интерфейс доступа к оборудованию "
"(чтение/запись регистров), реализованный драйверами для устройств с кодеком "
"AC97. В этом случае фактический интерфейс MIXER предоставляется общим кодом "
"AC97 в [.filename]#pcm#."

#. type: Title ===
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:126
#, no-wrap
msgid "The CHANNEL Interface"
msgstr "Интерфейс CHANNEL"

#. type: Title ====
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:128
#, no-wrap
msgid "Common Notes for Function Parameters"
msgstr "Общие примечания для параметров функций"

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:131
msgid ""
"Sound drivers usually have a private data structure to describe their "
"device, and one structure for each play and record data channel that it "
"supports."
msgstr ""
"Драйверы звука обычно имеют приватную структуру данных для описания своего "
"устройства и по одной структуре для каждого канала воспроизведения и записи, "
"который они поддерживают."

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:133
msgid ""
"For all CHANNEL interface functions, the first parameter is an opaque "
"pointer."
msgstr ""
"Для всех функций интерфейса CHANNEL первый параметр — это непрозрачный "
"указатель."

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:135
msgid ""
"The second parameter is a pointer to the private channel data structure, "
"except for `channel_init()` which has a pointer to the private device "
"structure (and returns the channel pointer for further use by [."
"filename]#pcm#)."
msgstr ""
"Второй параметр представляет собой указатель на приватную структуру данных "
"канала, за исключением `channel_init()`, где передаётся указатель на "
"приватную структуру устройства (и возвращается указатель на канал для "
"дальнейшего использования [.filename]#pcm#)."

#. type: Title ====
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:136
#, no-wrap
msgid "Overview of Data Transfer Operations"
msgstr "Обзор операций передачи данных"

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:139
msgid ""
"For sound data transfers, the [.filename]#pcm# core and the sound drivers "
"communicate through a shared memory area, described by a `struct snd_dbuf`."
msgstr ""
"Для надёжной передачи звуковых данных ядро [.filename]#pcm# и драйверы звука "
"взаимодействуют через общую область памяти, описываемую структурой `struct "
"snd_dbuf`."

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:141
msgid ""
"`struct snd_dbuf` is private to [.filename]#pcm#, and sound drivers obtain "
"values of interest by calls to accessor functions (`sndbuf_getxxx()`)."
msgstr ""
"`struct snd_dbuf` является приватной для [.filename]#pcm#, и драйверы звука "
"получают нужные значения через вызовы функций доступа (`sndbuf_getxxx()`)."

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:143
msgid ""
"The shared memory area has a size of `sndbuf_getsize()` and is divided into "
"fixed size blocks of `sndbuf_getblksz()` bytes."
msgstr ""
"Область разделяемой памяти имеет размер `sndbuf_getsize()` и разделена на "
"блоки фиксированного размера по `sndbuf_getblksz()` байт."

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:145
msgid ""
"When playing, the general transfer mechanism is as follows (reverse the idea "
"for recording):"
msgstr ""
"При воспроизведении общий механизм передачи выглядит следующим образом (для "
"записи идея обратная):"

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:148
msgid ""
"[.filename]#pcm# initially fills up the buffer, then calls the sound "
"driver's crossref:sound[channel-trigger,`xxxchannel_trigger()`] function "
"with a parameter of PCMTRIG_START."
msgstr ""
"[.filename]#pcm# сначала заполняет буфер, затем вызывает функцию crossref:"
"sound[channel-trigger,`xxxchannel_trigger()`] драйвера звука с параметром "
"PCMTRIG_START."

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:149
msgid ""
"The sound driver then arranges to repeatedly transfer the whole memory area "
"(`sndbuf_getbuf()`, `sndbuf_getsize()`) to the device, in blocks of "
"`sndbuf_getblksz()` bytes. It calls back the `chn_intr()`[.filename]#pcm# "
"function for each transferred block (this will typically happen at interrupt "
"time)."
msgstr ""
"Звуковой драйвер затем организует повторяющуюся передачу всей области памяти "
"(`sndbuf_getbuf()`, `sndbuf_getsize()`) на устройство блоками по "
"`sndbuf_getblksz()` байт. Для каждого переданного блока он вызывает функцию "
"`chn_intr()`[.filename]#pcm# (обычно это происходит во время прерывания)."

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:150
msgid ""
"`chn_intr()` arranges to copy new data to the area that was transferred to "
"the device (now free), and make appropriate updates to the `snd_dbuf` "
"structure."
msgstr ""
"`chn_intr()` организует копирование новых данных в область, которая была "
"передана устройству (теперь свободна), и вносит соответствующие обновления в "
"структуру `snd_dbuf`."

#. type: Title ====
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:152
#, no-wrap
msgid "channel_init"
msgstr "channel_init"

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:156
msgid ""
"`xxxchannel_init()` is called to initialize each of the play or record "
"channels.  The calls are initiated from the sound driver attach routine. "
"(See the crossref:sound[pcm-probe-and-attach,probe and attach section])."
msgstr ""
"`xxxchannel_init()` вызывается для инициализации каждого из каналов "
"воспроизведения или записи. Вызовы инициируются из процедуры подключения "
"драйвера звука. (См. раздел crossref:sound[pcm-probe-and-attach,Обнаружение "
"и подключение])."

#. type: delimited block . 4
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:168
#, no-wrap
msgid ""
"          static void *\n"
"          xxxchannel_init(kobj_t obj, void *data,\n"
"             struct snd_dbuf *b, struct pcm_channel *c, int dir) <.>\n"
"          {\n"
"              struct xxx_info *sc = data;\n"
"              struct xxx_chinfo *ch;\n"
"               ...\n"
"              return ch; <.>\n"
"           }\n"
msgstr ""
"          static void *\n"
"          xxxchannel_init(kobj_t obj, void *data,\n"
"             struct snd_dbuf *b, struct pcm_channel *c, int dir) <.>\n"
"          {\n"
"              struct xxx_info *sc = data;\n"
"              struct xxx_chinfo *ch;\n"
"               ...\n"
"              return ch; <.>\n"
"           }\n"

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:171
msgid ""
"`b` is the address for the channel `struct snd_dbuf`. It should be "
"initialized in the function by calling `sndbuf_alloc()`. The buffer size to "
"use is normally a small multiple of the 'typical' unit transfer size for "
"your device.`c` is the [.filename]#pcm# channel control structure pointer. "
"This is an opaque object. The function should store it in the local channel "
"structure, to be used in later calls to [.filename]#pcm# (ie: `chn_intr(c)`)."
"`dir` indicates the channel direction (`PCMDIR_PLAY` or `PCMDIR_REC`)."
msgstr ""
"`b` — это адрес для канала `struct snd_dbuf`. Он должен быть инициализирован "
"в функции вызовом `sndbuf_alloc()`. Размер буфера, который следует "
"использовать, обычно представляет собой небольшое кратное от 'типичного' "
"размера единицы передачи данных для вашего устройства. `c` — это указатель "
"на структуру управления каналом [.filename]#pcm#. Это непрозрачный объект. "
"Функция должна сохранить его в локальной структуре канала для использования "
"в последующих вызовах [.filename]#pcm# (например: `chn_intr(c)`). `dir` "
"указывает направление канала (`PCMDIR_PLAY` или `PCMDIR_REC`)."

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:173
msgid ""
"The function should return a pointer to the private area used to control "
"this channel. This will be passed as a parameter to other channel interface "
"calls."
msgstr ""
"Функция должна возвращать указатель на приватную область, используемую для "
"управления этим каналом. Этот указатель будет передаваться в качестве "
"параметра при других вызовах интерфейса канала."

#. type: Title ====
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:174
#, no-wrap
msgid "channel_setformat"
msgstr "channel_setformat"

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:177
msgid ""
"`xxxchannel_setformat()` should set up the hardware for the specified "
"channel for the specified sound format."
msgstr ""
"`xxxchannel_setformat()` должен настроить оборудование для указанного канала "
"под указанный звуковой формат."

#. type: delimited block . 4
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:187
#, no-wrap
msgid ""
"          static int\n"
"          xxxchannel_setformat(kobj_t obj, void *data, u_int32_t format) <.>\n"
"          {\n"
"              struct xxx_chinfo *ch = data;\n"
"               ...\n"
"              return 0;\n"
"           }\n"
msgstr ""
"          static int\n"
"          xxxchannel_setformat(kobj_t obj, void *data, u_int32_t format) <.>\n"
"          {\n"
"              struct xxx_chinfo *ch = data;\n"
"               ...\n"
"              return 0;\n"
"           }\n"

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:190
msgid ""
"`format` is specified as an `AFMT_XXX value` ([.filename]#soundcard.h#)."
msgstr ""
"`format` указывается как значение `AFMT_XXX` ([.filename]#soundcard.h#)."

#. type: Title ====
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:191
#, no-wrap
msgid "channel_setspeed"
msgstr "channel_setspeed"

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:194
msgid ""
"`xxxchannel_setspeed()` sets up the channel hardware for the specified "
"sampling speed, and returns the possibly adjusted speed."
msgstr ""
"`xxxchannel_setspeed()` настраивает оборудование канала для указанной "
"скорости дискретизации и возвращает возможно скорректированную скорость."

#. type: delimited block . 4
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:204
#, no-wrap
msgid ""
"          static int\n"
"          xxxchannel_setspeed(kobj_t obj, void *data, u_int32_t speed)\n"
"          {\n"
"              struct xxx_chinfo *ch = data;\n"
"               ...\n"
"              return speed;\n"
"           }\n"
msgstr ""
"          static int\n"
"          xxxchannel_setspeed(kobj_t obj, void *data, u_int32_t speed)\n"
"          {\n"
"              struct xxx_chinfo *ch = data;\n"
"               ...\n"
"              return speed;\n"
"           }\n"

#. type: Title ====
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:206
#, no-wrap
msgid "channel_setblocksize"
msgstr "channel_setblocksize"

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:209
msgid ""
"`xxxchannel_setblocksize()` sets the block size, which is the size of unit "
"transactions between [.filename]#pcm# and the sound driver, and between the "
"sound driver and the device. Typically, this would be the number of bytes "
"transferred before an interrupt occurs. During a transfer, the sound driver "
"should call [.filename]#pcm#'s `chn_intr()` every time this size has been "
"transferred."
msgstr ""
"`xxxchannel_setblocksize()` устанавливает размер блока, который является "
"размером единичных транзакций между [.filename]#pcm# и звуковым драйвером, а "
"также между звуковым драйвером и устройством. Обычно это количество байт, "
"передаваемых до возникновения прерывания. Во время передачи звуковой драйвер "
"должен вызывать `chn_intr()` из [.filename]#pcm# каждый раз, когда "
"передаётся данный размер."

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:211
msgid ""
"Most sound drivers only take note of the block size here, to be used when an "
"actual transfer will be started."
msgstr ""
"Большинство драйверов звука здесь учитывают только размер блока, который "
"будет использоваться при начале фактической передачи."

#. type: delimited block . 4
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:221
#, no-wrap
msgid ""
"          static int\n"
"          xxxchannel_setblocksize(kobj_t obj, void *data, u_int32_t blocksize)\n"
"          {\n"
"              struct xxx_chinfo *ch = data;\n"
"                ...\n"
"              return blocksize; <.>\n"
"           }\n"
msgstr ""
"          static int\n"
"          xxxchannel_setblocksize(kobj_t obj, void *data, u_int32_t blocksize)\n"
"          {\n"
"              struct xxx_chinfo *ch = data;\n"
"                ...\n"
"              return blocksize; <.>\n"
"           }\n"

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:224
msgid ""
"The function returns the possibly adjusted block size. In case the block "
"size is indeed changed, `sndbuf_resize()` should be called to adjust the "
"buffer."
msgstr ""
"Функция возвращает, возможно, скорректированный размер блока. Если размер "
"блока действительно изменён, следует вызвать `sndbuf_resize()` для "
"корректировки буфера."

#. type: Title ====
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:226
#, no-wrap
msgid "channel_trigger"
msgstr "channel_trigger"

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:229
msgid ""
"`xxxchannel_trigger()` is called by [.filename]#pcm# to control data "
"transfer operations in the driver."
msgstr ""
"`xxxchannel_trigger()` вызывается [.filename]#pcm# для управления операциями "
"передачи данных в драйвере."

#. type: delimited block . 4
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:239
#, no-wrap
msgid ""
"          static int\n"
"          xxxchannel_trigger(kobj_t obj, void *data, int go) <.>\n"
"          {\n"
"              struct xxx_chinfo *ch = data;\n"
"               ...\n"
"              return 0;\n"
"           }\n"
msgstr ""
"          static int\n"
"          xxxchannel_trigger(kobj_t obj, void *data, int go) <.>\n"
"          {\n"
"              struct xxx_chinfo *ch = data;\n"
"               ...\n"
"              return 0;\n"
"           }\n"

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:242
msgid "`go` defines the action for the current call. The possible values are:"
msgstr "`go` определяет действие для текущего вызова. Возможные значения:"

#. type: delimited block = 4
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:246
msgid ""
"If the driver uses ISA DMA, `sndbuf_isadma()` should be called before "
"performing actions on the device, and will take care of the DMA chip side of "
"things."
msgstr ""
"Если драйвер использует ISA DMA, перед выполнением действий с устройством "
"следует вызвать `sndbuf_isadma()`, которая позаботится о том, что делает DMA-"
"чип."

#. type: Title ====
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:248
#, no-wrap
msgid "channel_getptr"
msgstr "channel_getptr"

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:251
msgid ""
"`xxxchannel_getptr()` returns the current offset in the transfer buffer. "
"This will typically be called by `chn_intr()`, and this is how [."
"filename]#pcm# knows where it can transfer new data."
msgstr ""
"`xxxchannel_getptr()` возвращает текущее смещение в буфере передачи. Обычно "
"этот вызов выполняется функцией `chn_intr()`, и именно так [.filename]#pcm# "
"узнаёт, куда можно передавать новые данные."

#. type: Title ====
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:252
#, no-wrap
msgid "channel_free"
msgstr "channel_free"

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:255
msgid ""
"`xxxchannel_free()` is called to free up channel resources, for example when "
"the driver is unloaded, and should be implemented if the channel data "
"structures are dynamically allocated or if `sndbuf_alloc()` was not used for "
"buffer allocation."
msgstr ""
"`xxxchannel_free()` вызывается для освобождения ресурсов канала, например, "
"при выгрузке драйвера, и должна быть реализована, если структуры данных "
"канала динамически выделены или если `sndbuf_alloc()` не использовалась для "
"выделения буфера."

#. type: Title ====
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:256
#, no-wrap
msgid "channel_getcaps"
msgstr "channel_getcaps"

#. type: delimited block . 4
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:265
#, no-wrap
msgid ""
"          struct pcmchan_caps *\n"
"          xxxchannel_getcaps(kobj_t obj, void *data)\n"
"          {\n"
"              return &xxx_caps; <.>\n"
"           }\n"
msgstr ""
"          struct pcmchan_caps *\n"
"          xxxchannel_getcaps(kobj_t obj, void *data)\n"
"          {\n"
"              return &xxx_caps; <.>\n"
"           }\n"

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:268
msgid ""
"The routine returns a pointer to a (usually statically-defined) "
"`pcmchan_caps` structure (defined in [.filename]#sound/pcm/channel.h#. The "
"structure holds the minimum and maximum sampling frequencies, and the "
"accepted sound formats. Look at any sound driver for an example."
msgstr ""
"Подпрограмма возвращает указатель на (обычно статически определённую) "
"структуру `pcmchan_caps` (определена в [.filename]#sound/pcm/channel.h#). "
"Эта структура содержит минимальную и максимальную частоты дискретизации, а "
"также поддерживаемые звуковые форматы. Пример можно найти в любом драйвере "
"звукового устройства."

#. type: Title ====
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:269
#, no-wrap
msgid "More Functions"
msgstr "Дополнительные функции"

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:272
msgid ""
"`channel_reset()`, `channel_resetdone()`, and `channel_notify()` are for "
"special purposes and should not be implemented in a driver without "
"discussing it on the {freebsd-multimedia}."
msgstr ""
"`channel_reset()`, `channel_resetdone()` и `channel_notify()` предназначены "
"для специальных целей и не должны реализовываться в драйвере без обсуждения "
"на {freebsd-multimedia}."

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:274
msgid "`channel_setdir()` is deprecated."
msgstr "`channel_setdir()` устарела."

#. type: Title ===
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:275
#, no-wrap
msgid "The MIXER Interface"
msgstr "Интерфейс MIXER"

#. type: Title ====
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:278
#, no-wrap
msgid "mixer_init"
msgstr "mixer_init"

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:281
msgid ""
"`xxxmixer_init()` initializes the hardware and tells [.filename]#pcm# what "
"mixer devices are available for playing and recording"
msgstr ""
"`xxxmixer_init()` инициализирует оборудование и сообщает [.filename]#pcm#, "
"какие устройства микшера доступны для воспроизведения и записи"

#. type: delimited block . 4
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:289
#, no-wrap
msgid ""
"          static int\n"
"          xxxmixer_init(struct snd_mixer *m)\n"
"          {\n"
"              struct xxx_info   *sc = mix_getdevinfo(m);\n"
"              u_int32_t v;\n"
msgstr ""
"          static int\n"
"          xxxmixer_init(struct snd_mixer *m)\n"
"          {\n"
"              struct xxx_info   *sc = mix_getdevinfo(m);\n"
"              u_int32_t v;\n"

#. type: delimited block . 4
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:291
#, no-wrap
msgid "              [Initialize hardware]\n"
msgstr "              [Initialize hardware]\n"

#. type: delimited block . 4
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:296
#, no-wrap
msgid ""
"              [Set appropriate bits in v for play mixers] <.>\n"
"              mix_setdevs(m, v);\n"
"              [Set appropriate bits in v for record mixers]\n"
"              mix_setrecdevs(m, v)\n"
msgstr ""
"              [Set appropriate bits in v for play mixers] <.>\n"
"              mix_setdevs(m, v);\n"
"              [Set appropriate bits in v for record mixers]\n"
"              mix_setrecdevs(m, v)\n"

#. type: delimited block . 4
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:299
#, no-wrap
msgid ""
"              return 0;\n"
"          }\n"
msgstr ""
"              return 0;\n"
"          }\n"

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:302
msgid ""
"Set bits in an integer value and call `mix_setdevs()` and `mix_setrecdevs()` "
"to tell [.filename]#pcm# what devices exist."
msgstr ""
"Установите биты в целочисленном значении и вызовите `mix_setdevs()` и "
"`mix_setrecdevs()`, чтобы сообщить [.filename]#pcm#, какие устройства "
"существуют."

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:304
msgid ""
"Mixer bits definitions can be found in [.filename]#soundcard.h# "
"(`SOUND_MASK_XXX` values and `SOUND_MIXER_XXX` bit shifts)."
msgstr ""
"Определения битов микшера можно найти в [.filename]#soundcard.h# (значения "
"`SOUND_MASK_XXX` и сдвиги битов `SOUND_MIXER_XXX`)."

#. type: Title ====
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:305
#, no-wrap
msgid "mixer_set"
msgstr "mixer_set"

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:308
msgid "`xxxmixer_set()` sets the volume level for one mixer device."
msgstr ""
"`xxxmixer_set()` устанавливает уровень громкости для одного устройства "
"микшера."

#. type: delimited block . 4
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:319
#, no-wrap
msgid ""
"          static int\n"
"          xxxmixer_set(struct snd_mixer *m, unsigned dev,\n"
"                           unsigned left, unsigned right) <.>\n"
"          {\n"
"              struct sc_info *sc = mix_getdevinfo(m);\n"
"              [set volume level]\n"
"              return left | (right << 8); <.>\n"
"          }\n"
msgstr ""
"          static int\n"
"          xxxmixer_set(struct snd_mixer *m, unsigned dev,\n"
"                           unsigned left, unsigned right) <.>\n"
"          {\n"
"              struct sc_info *sc = mix_getdevinfo(m);\n"
"              [set volume level]\n"
"              return left | (right << 8); <.>\n"
"          }\n"

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:322
msgid ""
"The device is specified as a `SOUND_MIXER_XXX` value. The volume values are "
"specified in range [0-100]. A value of zero should mute the device."
msgstr ""
"Устройство указывается как значение `SOUND_MIXER_XXX`. Значения громкости "
"задаются в диапазоне [0-100]. Значение ноль должно отключать звук устройства."

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:323
msgid ""
"As the hardware levels probably will not match the input scale, and some "
"rounding will occur, the routine returns the actual level values (in range "
"0-100) as shown."
msgstr ""
"Поскольку уровни оборудования, вероятно, не совпадут с входной шкалой и "
"будет происходить округление, процедура возвращает фактические значения "
"уровней (в диапазоне 0-100), как показано."

#. type: Title ====
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:324
#, no-wrap
msgid "mixer_setrecsrc"
msgstr "mixer_setrecsrc"

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:327
msgid "`xxxmixer_setrecsrc()` sets the recording source device."
msgstr "`xxxmixer_setrecsrc()` устанавливает устройство источника записи."

#. type: delimited block . 4
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:334
#, no-wrap
msgid ""
"          static int\n"
"          xxxmixer_setrecsrc(struct snd_mixer *m, u_int32_t src) <.>\n"
"          {\n"
"              struct xxx_info *sc = mix_getdevinfo(m);\n"
msgstr ""
"          static int\n"
"          xxxmixer_setrecsrc(struct snd_mixer *m, u_int32_t src) <.>\n"
"          {\n"
"              struct xxx_info *sc = mix_getdevinfo(m);\n"

#. type: delimited block . 4
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:336
#, no-wrap
msgid "              [look for non zero bit(s) in src, set up hardware]\n"
msgstr "              [look for non zero bit(s) in src, set up hardware]\n"

#. type: delimited block . 4
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:340
#, no-wrap
msgid ""
"              [update src to reflect actual action]\n"
"              return src; <.>\n"
"           }\n"
msgstr ""
"              [update src to reflect actual action]\n"
"              return src; <.>\n"
"           }\n"

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:343
msgid "The desired recording devices are specified as a bit field"
msgstr "Желаемые устройства записи указываются в виде битового поля"

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:344
msgid ""
"The actual devices set for recording are returned. Some drivers can only set "
"one device for recording. The function should return -1 if an error occurs."
msgstr ""
"Возвращаются фактические устройства, настроенные для записи. Некоторые "
"драйверы могут настраивать только одно устройство для записи. Функция должна "
"возвращать -1 в случае ошибки."

#. type: Title ====
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:345
#, no-wrap
msgid "mixer_uninit, mixer_reinit"
msgstr "mixer_uninit, mixer_reinit"

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:348
msgid ""
"`xxxmixer_uninit()` should ensure that all sound is muted and if possible "
"mixer hardware should be powered down."
msgstr ""
"`xxxmixer_uninit()` должен гарантировать, что весь звук отключен, и, если "
"возможно, аппаратный микшер должен быть переведен в режим пониженного "
"энергопотребления."

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:350
msgid ""
"`xxxmixer_reinit()` should ensure that the mixer hardware is powered up and "
"any settings not controlled by `mixer_set()` or `mixer_setrecsrc()` are "
"restored."
msgstr ""
"`xxxmixer_reinit()` должна гарантировать, что аппаратура микшера включена и "
"все настройки, не управляемые `mixer_set()` или `mixer_setrecsrc()`, "
"восстановлены."

#. type: Title ===
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:351
#, no-wrap
msgid "The AC97 Interface"
msgstr "Интерфейс AC97"

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:354
msgid ""
"The _AC97_ interface is implemented by drivers with an AC97 codec. It only "
"has three methods:"
msgstr ""
"Интерфейс _AC97_ реализован драйверами с кодеком AC97. У него есть только "
"три метода:"

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:356
msgid "`xxxac97_init()` returns the number of ac97 codecs found."
msgstr "`xxxac97_init()` возвращает количество найденных кодеков ac97."

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:357
msgid "`ac97_read()` and `ac97_write()` read or write a specified register."
msgstr ""
"`ac97_read()` и `ac97_write()` читают или записывают указанный регистр."

#. type: Plain text
#: documentation/content/en/books/arch-handbook/sound/_index.adoc:358
msgid ""
"The _AC97_ interface is used by the AC97 code in [.filename]#pcm# to perform "
"higher level operations. Look at [.filename]#sound/pci/maestro3.c# or many "
"others under [.filename]#sound/pci/# for an example."
msgstr ""
"Интерфейс _AC97_ используется кодом AC97 в [.filename]#pcm# для выполнения "
"операций более высокого уровня. В качестве примера можно посмотреть [."
"filename]#sound/pci/maestro3.c# или другие файлы в [.filename]#sound/pci/#."