message_detach()

Отключить диапазон сообщений для обработчика

Прототип:

#include <sys/iofunc.h>
#include <sys/dispatch.h>
                                       
int message_detach( dispatch_t *dpp,
                    int low,
                    int high,
                    int flags );

Аргументы:

dpp

Дескриптор отправки, возвращаемый функцией dispatch_create().

low

high

Диапазон сообщений, для которых необходимо открепить обработчик. Диапазон должен быть тем же, что был передан функции message_attach().

flags

Зарезервировано.

Библиотека:

libc

Описание:

Функция message_detach() открепляет от сообщений из диапазона [low, high] функцию-обработчик, которая была прикреплена с помощью message_attach(), для дескриптора структуры диспетчера dpp.

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

0

Успешное завершение.

-1

Возникла ошибка.

EINVAL

Диапазон [low, high] не соответствует диапазону сообщений, к которому ранее с помощью функции message_attach() был прикреплён обработчик.

Примеры:

#include <sys/dispatch.h>
#include <time.h>
#include <stdio.h>
#include <stdlib.h>
                                       
int my_func( ... )
{
   ...
}
        
int main( int argc, char **argv )
{
    dispatch_t  *dpp;
    int         lo=0x2000, hi=0x2fff, flags=0;
        
    if ( ( dpp = dispatch_create() ) == NULL )
    {
        fprintf( stderr, "%s: Unable to allocate dispatch handle.\n", argv[0] );
        return (EXIT_FAILURE);
    }
    ...
                                       
    if ( message_attach( dpp, NULL, lo, hi, &my_func, NULL) == -1 )
    {
        fprintf( stderr, "%s: Failed to attach message range.\n", argv[0] );
        return (1);
    }
    ...
                                       
    if ( message_detach( dpp, lo, hi, flags ) == -1 )
    {
        fprintf( stderr, "Failed to detach message range from %d to %d.\n", lo, hi );
        return (1);
    }
    /* else message was detached */
    ...
}

Другие примеры, использующие интерфейс диспетчера см. на страницах dispatch_create(), message_attach(), resmgr_attach() и thread_pool_create().

Классификация:

ЗОСРВ «Нейтрино»

Безопасность использования

Точка остановки потока

Да

Обработчик прерываний

Нет

Обработчик сигналов

Нет

В потоке

Да

Тематические ссылки:

message_attach()

Предыдущий раздел: Описание API системной библиотеки