Заголовок acxtargets.h
Заголовок acxtargets используется расширениями аудиокласса ACX. Дополнительные сведения см. в статье Общие сведения о расширениях класса звука ACX.
WdfIoTarget — это абстракция WDF для упрощения взаимодействия между двумя разными стеками. ACX использует WdfIoTarget для упрощения взаимодействия между объектами ACX, каналами, контактами, потоками, элементами и фабриками цепи.
ACX использует следующие объекты ACX для поддержки обмена данными между целевыми объектами. Дополнительные сведения см. в разделе ACX — сводка по объектам ACX.
Драйверы используют AcxTargetCircuit для взаимодействия с удаленным каналом, предоставляемым другим стеком. AcxTargetCircuit реализуется с помощью WdfIoTarget.
Драйверы используют AcxTargetPin для взаимодействия с контактом удаленного канала, предоставляемым другим стеком. AcxTargetPin реализуется с помощью WdfIoTarget для отправки сообщений в сущность удаленного закрепления.
Драйверы используют AcxTargetStream для взаимодействия с потоком удаленного канала, предоставляемым другим стеком. AcxTargetStream реализуется с помощью WdfIoTarget для создания удаленного потока и изменения состояния удаленного потока.
Драйверы используют AcxTargetElement для взаимодействия с элементом удаленного канала, предоставляемым другим стеком. AcxTargetElement реализуется с помощью WdfIoTarget для отправки сообщений в сущность удаленного элемента.
Драйверы используют AcxTargetFactoryCircuit для взаимодействия с экземпляром удаленной фабрики цепи. AcxTargetFactoryCircuit реализуется с помощью WdfIoTarget для отправки сообщений в фабрику удаленных каналов.
Для взаимодействия с удаленным каналом каждый из указанных выше типов ACX поддерживает:
- properties
- methods
- события
Дополнительные сведения см. в разделе:
Примечание
Заголовки и библиотеки ACX не включены в WDK 10.0.22621.2428 (выпущен 24 октября 2023 г.), но доступны в предыдущих версиях, а также в последних (сборках серии 25000) Insider Preview WDK. Дополнительные сведения о предварительных версиях WDK см. в статье Установка предварительных версий пакета драйверов Windows (WDK).
acxtargets.h содержит следующие программные интерфейсы:
Функции
| ACX_TARGET_CIRCUIT_CONFIG_INIT Функция ACX_TARGET_CIRCUIT_CONFIG_INIT инициализирует структуру конфигурации целевого канала ACX. |
| ACX_TARGET_FACTORY_CIRCUIT_CONFIG_INIT Функция ACX_TARGET_FACTORY_CIRCUIT_CONFIG_INIT инициализирует структуру конфигурации целевого канала фабрики ACX. |
| ACX_TARGET_STREAM_CONFIG_INIT Функция ACX_TARGET_STREAM_CONFIG_INIT инициализирует структуру конфигурации целевого потока ACX. |
| AcxTargetCircuitCreate Функция AcxTargetCircuitCreate используется для создания целевого канала ACX. |
| AcxTargetCircuitFormatRequestForMethod AcxTargetCircuitFormatRequestForMethod форматирует WDFREQUEST как запрос метода ACX для использования на указанном целевом объекте канала. |
| AcxTargetCircuitFormatRequestForProperty AcxTargetCircuitFormatRequestForProperty форматирует WDFREQUEST как запрос свойства ACX для использования в указанном целевом канале. |
| AcxTargetCircuitGetElementsCount Функция AcxTargetCircuitGetElementsCount возвращает количество элементов ACX на удаленном целевом объекте. |
| AcxTargetCircuitGetPinsCount Функция AcxTargetCircuitGetPinsCount возвращает количество контактов ACX на удаленном целевом объекте. |
| AcxTargetCircuitGetSymbolicLinkName Функция AcxTargetCircuitGetSymbolicLinkName извлекает символьное имя ссылки для целевого канала ACX. |
| AcxTargetCircuitGetTargetElement Функция AcxTargetCircuitGetTargetElement с допустимым значением индекса элемента вернет связанный объект ACXTARGETELEMENT. |
| AcxTargetCircuitGetTargetPin Функция AcxTargetCircuitGetTargetPin, учитывая допустимое значение индекса контакта, вернет связанный объект ACXTARGETPIN. |
| AcxTargetCircuitGetWdfIoTarget Функция AcxTargetCircuitGetWdfIoTarget вернет связанный объект WDFIOTARGET. |
| AcxTargetElementFormatRequestForMethod Функция AcxTargetElementFormatRequestForMethod форматирует WDFREQUEST как запрос метода ACX для использования в указанном целевом элементе. |
| AcxTargetElementFormatRequestForProperty AcxTargetElementFormatRequestForProperty форматирует WDFREQUEST как запрос свойства ACX для использования в указанном целевом элементе. |
| AcxTargetElementGetId AcxTargetElementGetId при наличии существующего объекта ACXTARGETELEMENT возвращает соответствующее значение идентификатора. |
| AcxTargetElementGetNameTag AcxTargetElementGetNameTag, заданный существующим объектом ACXTARGETELEMENT, возвращает свой тег name-tag в виде GUID. |
| AcxTargetElementGetType Функция AcxTargetElementGetType при наличии существующего объекта ACXTARGETELEMENT возвращает соответствующий тип элемента в виде GUID. |
| AcxTargetElementGetWdfIoTarget AcxTargetElementGetWdfIoTarget, если задан существующий объект ACXTARGETELEMENT, возвращает соответствующий объект WDFIOTARGET. |
| AcxTargetFactoryCircuitCreate Функция AcxTargetFactoryCircuitCreate возвращает дескриптор новому объекту ACXTARGETFACTORYCIRCUIT ACX. |
| AcxTargetFactoryCircuitFormatRequestForMethod AcxTargetFactoryCircuitFormatRequestForMethod форматирует WDFREQUEST как запрос метода ACX для использования в указанном целевом объекте фабрики цепи. |
| AcxTargetFactoryCircuitFormatRequestForProperty AcxTargetFactoryCircuitFormatRequestForProperty форматирует WDFREQUEST как запрос свойства ACX для использования в указанном целевом объекте фабрики цепи. |
| AcxTargetFactoryCircuitGetWdfIoTarget AcxTargetFactoryCircuitGetWdfIoTarget при наличии существующего объекта ACXTARGETFACTORYCIRCUIT возвращает соответствующий объект WDFIOTARGET. |
| AcxTargetPinFlushModeDataFormatListCache Функция AcxTargetPinFlushModeDataFormatListCache очищает кэш списка форматов данных режима для указанного целевого контакта. |
| AcxTargetPinFormatRequestForMethod Функция AcxTargetPinFormatRequestForMethod форматирует WDFREQUEST как запрос метода ACX для использования в указанном целевом объекте закрепления. |
| AcxTargetPinFormatRequestForProperty AcxTargetPinFormatRequestForProperty форматирует WDFREQUEST как запрос свойства ACX для использования в указанном целевом объекте контактов. |
| AcxTargetPinGetId AcxTargetPinGetId, заданный существующим объектом ACXTARGETPIN, возвращает связанное значение идентификатора. |
| AcxTargetPinGetWdfIoTarget Функция AcxTargetPinGetWdfIoTarget при наличии существующего объекта ACXTARGETPIN возвращает соответствующий объект WDFIOTARGET. |
| AcxTargetPinRetrieveModeDataFormatList Функция AcxTargetPinRetrieveModeDataFormatList, учитывая существующий объект ACXTARGETPIN, возвращает ACXDATAFORMATLIST, связанный с указанным списком форматов данных в режиме обработки сигнала. |
| AcxTargetStreamAssignDrmContentId Функция AcxTargetStreamAssignDrmContentId при использовании существующего объекта ACXTARGETSTREAM назначает этот потоку идентификатор содержимого DRM. |
| AcxTargetStreamCreate Функция AcxTargetStreamCreate используется для создания целевого потока. |
| AcxTargetStreamFormatRequestForMethod AcxTargetStreamFormatRequestForMethod форматирует WDFREQUEST как запрос метода ACX для использования в указанном целевом объекте потока. |
| AcxTargetStreamFormatRequestForProperty AcxTargetStreamFormatRequestForProperty форматирует WDFREQUEST как запрос свойства ACX для использования в указанном целевом объекте потока. |
| AcxTargetStreamGetElementsCount Функция AcxTargetStreamGetElementsCount, заданная объектом ACXTARGETSTREAM, возвращает количество элементов ACX. |
| AcxTargetStreamGetTargetElement Функция AcxTargetStreamGetTargetElement, заданная допустимым значением индекса элемента, возвращает соответствующий объект ACXTARGETELEMENT ACX, связанный с указанным потоком. |
| AcxTargetStreamGetWdfIoTarget Функция AcxTargetStreamGetWdfIoTarget возвращает объект WDFIOTARGET WDF, связанный с указанным потоком. |
Структуры
| ACX_TARGET_CIRCUIT_CONFIG Структура ACX_TARGET_CIRCUIT_CONFIG используется для определения конфигурации целевого канала. |
| ACX_TARGET_FACTORY_CIRCUIT_CONFIG Структура ACX_TARGET_FACTORY_CIRCUIT_CONFIG используется для определения конфигурации целевого канала фабрики. |
| ACX_TARGET_STREAM_CONFIG Структура ACX_TARGET_STREAM_CONFIG используется для определения конфигурации целевого потока. |
Перечисления
| ACX_TARGET_CIRCUIT_CONFIG_FLAGS Перечисление ACX_TARGET_CIRCUIT_CONFIG_FLAGS определяет флаги конфигурации для целевого канала ACX. |
| ACX_TARGET_FACTORY_CIRCUIT_CONFIG_FLAGS Перечисление ACX_TARGET_FACTORY_CIRCUIT_CONFIG_FLAGS определяет флаги конфигурации для фабрики целевых каналов ACX. |
| ACX_TARGET_STREAM_CONFIG_FLAGS Перечисление ACX_TARGET_STREAM_CONFIG_FLAGS определяет флаги конфигурации для целевого потока ACX. |
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по