Функции работы с блокировками чтения/записи объявлены, как и большинство примитивов синхронизации, в заголовочном файле

.

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

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

Вместо прямого вызова функции

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

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

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

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

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

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

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

Функция

может возвращать следующие значения:

— успешное выполнение;

— при первом использовании статически инициированной блокировки чтения/записи ( ) недостаточно системных ресурсов для инициализации блокировки чтения/записи;

— вызывающий поток уже провел эксклюзивный захват (блокировку по записи) объекта синхронизации, на который ссылается , и повторный захват на чтение привел бы к полному («мертвому») блокированию потока;

— сбой при обращении ядра к ;

— указывает на неверный объект блокировки чтения/записи.

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

Функция

возвращает следующие значения:

— успешное выполнение;

— при первом использовании статически инициированной блокировки чтения/записи ( ) недостаточно системных ресурсов для инициализации блокировки чтения/записи;

— блокировка чтения/записи блокирована по записи (собственно, это и есть основной мотив использования именно этого вызова);

— вызывающий поток уже провел эксклюзивный захват (блокировку по записи) объекта синхронизации, на который ссылается ;

— сбой при обращении ядра к ;

— указывает на неверный объект блокировки чтения/записи.

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