Ссылка менеджера компонентов

Обсуждение

Ваше приложение должно открыть компонент, прежде чем оно сможет вызвать любые функции компонента. Для использования этой функции Вы, должно быть, уже получили идентификатор компонента. Также можно использовать OpenDefaultComponent функционируйте для открытия компонента без вызова FindNextComponent.

Обратите внимание на то, что Ваше приложение может поддержать несколько соединений с единственным компонентом, или оно может иметь соединения с несколькими компонентами одновременно.

Обсуждение

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

Обсуждение

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

Обсуждение

Для получения информации о регистрирующихся компонентах см. “Регистрирующиеся Компоненты”.

Обсуждение

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

Как только Вы получили код ошибки, Менеджер компонентов очищает код ошибки для соединения. Если Вы хотите сохранить то ошибочное значение, необходимо сохранить его в локальном хранении приложения.

Обсуждение

Core Services поддерживает флаг режима потока компонента для каждого потока в текущем процессе. Значение по умолчанию этого флага kCSAcceptAllComponentsMode, что означает, что поток может вызвать любой компонент независимо от того, ориентирован ли компонент на многопотоковое исполнение. Приложения и другой высокоуровневый код, вызывающие компонентно-ориентированный APIs (такой как QuickTime) от приоритетных потоков, должны вызвать эту функцию от своего потока заранее и передачи в значении kCSAcceptThreadSafeComponentsOnlyMode.

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

Обсуждение

Посмотрите ComponentRoutineProcPtr обратный вызов для получения дополнительной информации.

Обсуждение

Посмотрите ComponentRoutineProcPtr обратный вызов для получения дополнительной информации.

Обсуждение

Посмотрите ComponentRoutineProcPtr обратный вызов для получения дополнительной информации.

Обсуждение

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

Компоненты Вы регистрируетесь в RegisterComponent когда Вы вызываете эту функцию, функция должна быть в памяти. Если Вы хотите зарегистрировать компонент, который сохранен в ветви ресурсов файла, используйте RegisterComponentResource функция. Используйте RegisterComponentResourceFile функционируйте для регистрации всех компонентов в ветви ресурсов файла. Менеджер компонентов автоматически регистрирует ресурсы компонента, сохраненные в файлах типами файлов 'thng' это сохранено в папке Extensions. См. «Ресурсы» для получения дополнительной информации о файлах ресурсов компонента.

Обратите внимание на то, что компонент, находящийся в Вашей «куче» приложения, остается зарегистрированным, пока Ваше приложение не не регистрирует его или выходы. Когда приложение выходит, Менеджер компонентов автоматически закрывает любые соединения компонентов к тому приложению. Кроме того, если приложение зарегистрировало компоненты, находящиеся в его пространстве «кучи», Менеджер компонентов автоматически не регистрирует те компоненты. Компонент, находящийся в системной «куче» и зарегистрированный Вашим приложением, остается зарегистрированным, пока Ваше приложение не не регистрирует его или пока не закрывается компьютер.

Обсуждение

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

Если Вы хотите зарегистрировать компонент, который находится в памяти, используйте RegisterComponent функция.

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

Обратите внимание на то, что компонент, зарегистрированный локально Вашим приложением, остается зарегистрированным, пока Ваше приложение не не регистрирует его или выходы. Когда приложение выходит, Менеджер компонентов автоматически закрывает любые соединения компонентов к тому приложению. Кроме того, если приложение зарегистрировало компоненты, находящиеся в его пространстве «кучи», Менеджер компонентов автоматически не регистрирует те компоненты. Компонент, зарегистрированный глобально Вашим приложением, остается зарегистрированным, пока Ваше приложение не не регистрирует его или пока не закрывается компьютер.

Обсуждение

Прежде чем компонент может использоваться приложением, компонент должен быть зарегистрирован в Менеджере компонентов. Менеджер компонентов автоматически регистрирует ресурсы компонента, сохраненные в файлах типами файлов 'thng' это сохранено в папке Extensions. Для описания формата и содержания ресурсов компонента, см. «Ресурсы».

Обсуждение

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

Обсуждение

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

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

Обсуждение

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

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

Подпрограммы компонента, которым не нужны глобальные данные, должны использовать CallComponentFunction вместо этого.

Обсуждение

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

Обсуждение

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

Ваш компонент говорит Менеджер компонентов о памяти, связанной с соединением путем вызова SetComponentInstanceStorage функция.

Обсуждение

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

Ваш компонент должен избавиться от любой выделенной памяти для соединения только в ответ на близкий запрос. Обратите внимание на то, что каждый раз, когда открытый запрос перестал работать, Менеджер компонентов всегда выпускает близкий запрос. Кроме того, значение, сохраненное этой функцией, всегда передается близкому запросу, таким образом, это должно быть допустимо или NULL. Если открытый запрос пытается избавиться от своей выделенной памяти перед возвратом, он должен вызвать эту функцию снова с a NULL дескриптор, чтобы препятствовать Менеджеру компонентов передавать недопустимый дескриптор близкому запросу.

Обсуждение

Ваш компонент может предназначаться для экземпляра компонента, не получая компонент, или Ваш компонент может сначала получить компонент и затем предназначаться для определенного экземпляра компонента.

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

Обсуждение

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

Приложения получают эту информацию об ошибке путем вызова GetComponentInstanceError функция. Документация для Вашего компонента должна указать, как компонент указывает ошибки.

Обсуждение

Существует одна ссылочная константа для каждого компонента, независимо от числа соединений с тем компонентом. Когда Ваш компонент регистрируется, Менеджер компонентов устанавливает эту ссылочную константу в 0.

Ссылочная константа является 4-байтовым значением, которое Ваш компонент может использовать всегда, Вы решаете. Например, Вы могли бы использовать ссылочную константу для хранения адреса структуры данных, совместно использующейся всеми соединениями, сохраняемыми компонентом. Необходимо выделить совместно использованные структуры в системной «куче». Ваш компонент должен освободить структуру, когда ее последнее соединение закрывается или когда это не зарегистрировано.

Обсуждение

Существует одна ссылочная константа для каждого компонента, независимо от числа соединений с тем компонентом. Когда Ваш компонент регистрируется, Менеджер компонентов устанавливает эту ссылочную константу в 0.

Ссылочная константа является 4-байтовым значением, которое Ваш компонент может использовать всегда, Вы решаете. Например, Вы могли бы использовать ссылочную константу для хранения адреса структуры данных, совместно использующейся всеми соединениями, сохраняемыми компонентом. Необходимо выделить совместно использованные структуры в системной «куче». Ваш компонент должен освободить структуру, когда ее последнее соединение закрывается или когда это не зарегистрировано.

Обсуждение

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

Ваш компонент может использовать FSpOpenResFile или эквивалентный Менеджер ресурсов функционирует для открытия других файлов ресурсов, но необходимо использовать эту функцию для открытия файла ресурсов компонента.

Если Вы храните свой компонент в ресурсе компонента, но регистрируете компонент в RegisterComponent функция, а не с RegisterComponentResource или RegisterComponentResourceFile функция, Ваш компонент не может получить доступ к своему файлу ресурсов с этой функцией.

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

Обсуждение

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

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

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

Ваш компонент никогда не должен использовать эту функцию с открытыми или близкими запросами от Менеджера компонентов — всегда используют OpenComponent и CloseComponent функции для управления соединениями с другими компонентами.

Обсуждение

Как правило, Ваш компонент получает другой компонент, когда Вы хотите переопределить все или некоторые функции, предоставленные компонентом или обеспечить новые функции. Например, компонент под названием NewMath мог бы получить компонент под названием OldMath. Предположим, что компонент NewMath обеспечивает новую функцию, DoExponent. Каждый раз, когда NewMath получает запрос экспоненты, он может обработать сам запрос. Для всех других запросов NewMath мог бы вызвать компонент OldMath для выполнения запроса.

После получения компонента Ваш компонент мог бы принять решение предназначаться для определенного экземпляра полученного компонента.

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

Обсуждение

Эта функция восстанавливает указанный компонент к списку доступных компонентов. Приложения могут тогда получить доступ к компоненту и получить информацию о функциях Менеджера компонентов использования компонента.

Обсуждение

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