ProtocolCmDropParty
NDIS_STATUS
ProtocolCmDropParty(
IN NDIS_HANDLE CallMgrPartyContext,
IN PVOID CloseData OPTIONAL,
IN UINT Size OPTIONAL
);
|
ProtocolCmDropParty 함수는 존재하는 멀티포인트 호출로부터 콜 매니저가 파티를 제거하는 것을 요구하기 위해 NDIS가 요구할 필요한 함수이다.
매개변수
- CallMgrPartyContext
- 콜 매니저가 파티당 상태를 유지하는 콜 매니저 할당 컨텍스트 영역에 대한 핸들을 지정한다. 이 핸들은 콜 매니저들의 ProtocolCmPartyAddParty 함수내에서 NDIS에게 제공된다.
- CloseData
- 파티가 드랍되기 전에 연결을 가로질러 보내어질 연결 지향 클라이언트 특정 데이터를 포함하는 버퍼를 가리킨다. 이 매개변수는 만약 아래 네트워크 미디엄이 연결을 닫을 때 데이터 전송들을 지원하지 않는다면 NULL이다.
- Size
- 만약 CloseData가 NULL이면 0이고, CloseData 버퍼의 바이트 길이를 지정한다.
리턴값
ProtocolCmDropParty 함수는 다음과 같은 값들 중 하나로서 연산들의 상태를 리턴한다.
- NDIS_STATUS_SUCCESS
- 콜 매니저는 성공적으로 어떤 Close Data를 보내는 파티가 드랍됐다는 것을 가리키고 컨텍스트 영역을 위해 할당된 자원들을 해제한다.
- NDIS_STATUS_PENDING
- 콜 매니저는 비동기적으로 파티를 드랍하기 위한 요구를 완성할 것이라는 것을 가리킨다. 콜 매니저는 모든 처리가 파티가 드랍된 요구 actor와 NDIS에게 알리기 위해 마쳐야 될 때 NdisCmDropPartyComplete 함수를 호출해야 한다.
- NDIS_STATUS_INVALID_DATA
- CloseData가 콜 매니저에게 지정됐다는 것을 가리키지만, 미디어 타입이 연결 종료와 같이 발생한 데이터를 전송하는 것을 지원하지 않는다.
주석
ProtocolCmDropParty 함수는 존재하는 멀티포인트 호출로부터 파티를 드랍하기 위해 미디어를 위해 필요한 다른 미디어 특정 에이전트들과 혹은 네트워크 제어 장치들과 통신한다. 만약 콜 매니저가 네트워크 제어 에이전트(네트워크 스위치 등)들과 통신하기 위해 필요된다면, ProtocolBidnAdapter 함수에서 설립된 네트워크 제어 에이전트들에 대해 가상 연결을 사용해야 한다.
만약 CloseData가 NULL이 아니고 연결 종료될 때 데이터를 보내는 것이 미디어 타입에 의해 지원된다면, 콜 매니저는 종료를 완성하기 전에 CloseData에 지정된 데이터를 전송해야 한다. 만약 연결 종료와 함께 발생한 데이터를 보내는 것이 미디어 타입에 의해 지원되지 않는다면, 콜 매니저는 NDIS_STATUS_INVALID_DATA로 제어를 리턴해야 한다.
콜 매니저는 또한 CallMgrPartyContext에 저장되고 할당된 어떤 파티당 자원들을 해제해야 한다. 추가적으로, 콜 매니저는 CallMgrPartyContext 자체에 저장된 버퍼를 해제해야 한다. 그렇게 하는 것에 대한 실패는 메모리 누수 조건를 초래할 것이다.
ProtocolCmDropParty 함수는 IRQL DISPATCH_LEVEL에서 실행될 수 있도록 짜여져야 한다.
|