/* 用当前RTSPSession构造一个OSRef实例, 在RTPSession Map(Hash表)中注册并加入该引用OSRef元(其key值唯一),
同时更新qtssSvrClientSessions的属性,及QTSServerInterface中的总RTPSession数 */
QTSS_Error RTPSession::Activate(const StrPtrLen& inSessionID)
{
//Set the session ID for this session
/* 用入参配置fRTSPSessionIDBuf的值(是C-String) */
Assert(inSessionID.Len <= QTSS_MAX_SESSION_ID_LENGTH);
::memcpy(fRTSPSessionIDBuf, inSessionID.Ptr, inSessionID.Len);
fRTSPSessionIDBuf[inSessionID.Len] = '\0';
/* 用C-String的fRTSPSessionIDBuf设置qtssCliSesRTSPSessionID的属性值 */
this->SetVal(qtssCliSesRTSPSessionID, &fRTSPSessionIDBuf[0], inSessionID.Len);
/* 用qtssCliSesRTSPSessionID的属性值来得到一个RTPSession Map的引用OSRef元 */
fRTPMapElem.Set(*this->GetValue(qtssCliSesRTSPSessionID), this);
/* 获取服务器接口 */
QTSServerInterface* theServer = QTSServerInterface::GetServer();
//Activate puts the session into the RTPSession Map
/* 在RTPSession Map(Hash表)中注册并加入一个引用OSRef,若字符串标识唯一,就能成功返回OS_NoErr;若有一个相同key值的元素,就返回错误EPERM */
QTSS_Error err = theServer->GetRTPSessionMap()->Register(&fRTPMapElem);
//若有同名键值,立即返回
if (err == EPERM)
return err;
/* 确保key值唯一 */
Assert(err == QTSS_NoErr);
//
// Adding this session into the qtssSvrClientSessions attr and incrementing the number of sessions must be atomic
/* 锁定服务器对象 */
OSMutexLocker locker(theServer->GetMutex());
//
// Put this session into the qtssSvrClientSessions attribute of the server
#if DEBUG
Assert(theServer->GetNumValues(qtssSvrClientSessions) == theServer->GetNumRTPSessions());//确保属性qtssSvrClientSessions中的RTPSession个数和服务器中实际的个数相同
#endif
/* 设置qtssSvrClientSessions的第GetNumRTPSessions()个RTPSession的属性 */
RTPSession* theSession = this;
err = theServer->SetValue(qtssSvrClientSessions, theServer->GetNumRTPSessions(), &theSession, sizeof(theSession), QTSSDictionary::kDontObeyReadOnly);
Assert(err == QTSS_NoErr);
#if DEBUG
fActivateCalled = true;
#endif
/* 及时更新QTSServerInterface中的总RTPSession数 */
QTSServerInterface::GetServer()->IncrementTotalRTPSessions();
return QTSS_NoErr;
}
QTSS_Error RTPSession::Activate(const StrPtrLen& inSessionID)
{
//Set the session ID for this session
Assert(inSessionID.Len <= QTSS_MAX_SESSION_ID_LENGTH);
::memcpy(fRTSPSessionIDBuf, inSessionID.Ptr, inSessionID.Len);
fRTSPSessionIDBuf[inSessionID.Len] = '\0';
this->SetVal(qtssCliSesRTSPSessionID, &fRTSPSessionIDBuf[0], inSessionID.Len);
fRTPMapElem.Set(*this->GetValue(qtssCliSesRTSPSessionID), this);
QTSServerInterface* theServer = QTSServerInterface::GetServer();
//Activate puts the session into the RTPSession Map
QTSS_Error err = theServer->GetRTPSessionMap()->Register(&fRTPMapElem);
if (err == EPERM)
return err;
Assert(err == QTSS_NoErr);
//
// Adding this session into the qtssSvrClientSessions attr and incrementing the number of sessions must be atomic
OSMutexLocker locker(theServer->GetMutex());
//
// Put this session into the qtssSvrClientSessions attribute of the server
#if DEBUG
Assert(theServer->GetNumValues(qtssSvrClientSessions) == theServer->GetNumRTPSessions());
#endif
RTPSession* theSession = this;
err = theServer->SetValue(qtssSvrClientSessions, theServer->GetNumRTPSessions(), &theSession, sizeof(theSession), QTSSDictionary::kDontObeyReadOnly);
Assert(err == QTSS_NoErr);
#if DEBUG
fActivateCalled = true;
#endif
QTSServerInterface::GetServer()->IncrementTotalRTPSessions();
return QTSS_NoErr;
}
void WINAPI ServiceControl(DWORD inControlCode)
{
QTSS_ServerState theState;
QTSServerInterface* theServer = QTSServerInterface::GetServer();
DWORD theStatusReport = SERVICE_START_PENDING;
if (theServer != NULL)
theState = theServer->GetServerState();
else
theState = qtssStartingUpState;
switch (inControlCode)
{
// Stop the service.
//
case SERVICE_CONTROL_STOP:
case SERVICE_CONTROL_SHUTDOWN:
{
if (theState == qtssStartingUpState)
break;
//
// Signal the server to shut down.
theState = qtssShuttingDownState;
if (theServer != NULL)
theServer->SetValue(qtssSvrState, 0, &theState, sizeof(theState));
break;
}
case SERVICE_CONTROL_PAUSE:
{
if (theState != qtssRunningState)
break;
//
// Signal the server to refuse new connections.
theState = qtssRefusingConnectionsState;
if (theServer != NULL)
theServer->SetValue(qtssSvrState, 0, &theState, sizeof(theState));
break;
}
case SERVICE_CONTROL_CONTINUE:
{
if (theState != qtssRefusingConnectionsState)
break;
//
// Signal the server to refuse new connections.
theState = qtssRefusingConnectionsState;
if (theServer != NULL)
theServer->SetValue(qtssSvrState, 0, &theState, sizeof(theState));
break;
}
case SERVICE_CONTROL_INTERROGATE:
break; // Just update our status
default:
break;
}
if (theServer != NULL)
{
theState = theServer->GetServerState();
//
// Convert a QTSS state to a Win32 Service state
switch (theState)
{
case qtssStartingUpState: theStatusReport = SERVICE_START_PENDING; break;
case qtssRunningState: theStatusReport = SERVICE_RUNNING; break;
case qtssRefusingConnectionsState: theStatusReport = SERVICE_PAUSED; break;
case qtssFatalErrorState: theStatusReport = SERVICE_STOP_PENDING; break;
case qtssShuttingDownState: theStatusReport = SERVICE_STOP_PENDING; break;
default: theStatusReport = SERVICE_RUNNING; break;
}
}
else
theStatusReport = SERVICE_START_PENDING;
qtss_printf("Reporting status from ServiceControl function\n");
::ReportStatus(theStatusReport, NO_ERROR);
}