Текущий раздел:

Описания RDS

Приложения

Приложение А. Функции, константы и структуры RDS

А.5. Сервисные функции и макросы RDS

А.5.13. Вызов функций блоков

А.5.13.8. rdsCallBlockFunctionDelayed – отложенный вызов функции блока (устаревшая)

# Приложения

## Приложение А. Функции, константы и структуры RDS

### А.5. Сервисные функции и макросы RDS

#### А.5.13. Вызов функций блоков

##### А.5.13.8. rdsCallBlockFunctionDelayed – отложенный вызов функции блока (устаревшая)

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

      void RDSCALL rdsCallBlockFunctionDelayed(
        RDS_BHANDLE Block,    // Вызываемый блок
        int FuncId,           // Идентификатор функции
        LPVOID pParamBuf,     // Указатель на область параметров функции
        DWORD ParamBufSize    // Размер области параметров
      );

Тип указателя на эту функцию

RDS_VBhIpVDw

Параметры

Block(RDS_BHANDLE)
  Идентификатор блока, функция которого будет вызвана (модель этого блока будет реагировать на событие RDS_BFM_FUNCTIONCALL).
FuncId(int)
  Целый идентификатор вызываемой функции, полученный при ее регистрации вызовом rdsRegisterFunction.
pParamBuf(LPVOID)
  Указатель на область параметров функции, которая будет скопирована во внутреннюю память RDS. Область параметров не должна содержать внутри себя какие-либо указатели на другие области памяти и объекты. Может равняться NULL.
ParamBufSize(DWORD)
  Размер (в байтах) области параметров, указатель на которую передан в pParams.

Примечания

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

Поле | Значение
--- | ---
int Function | значение параметра FuncId
LPVOID Data | указатель на внутреннюю область памяти RDS размером в ParamBufSize байтов, в которую скопирована область pParamBuf
RDS_BHANDLE Caller | идентификатор блока, из модели которого вызвана rdsCallBlockFunctionDelayed
BOOL Broadcast | FALSE
int BroadcastCnt | 0
BOOL Stop | FALSE
BOOL Delayed | TRUE
DWORD DataBufSize | значение параметра ParamBufSize

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

Отложенный вызов функций блоков рассматривается в §2.13.5 руководства программиста.

См. также

RDS_BFM_FUNCTIONCALL, RDS_FUNCTIONCALLDATA, rdsQueueCallBlockFunction, rdsCallBlockFunction, rdsBroadcastFunctionCallsEx, rdsRegisterFunction.