NdisCmAddPartyComplete 함수(ndis.h)

NdisCmAddPartyComplete 는 이전에 호출 관리자가 NDIS_STATUS_PENDING 반환한 클라이언트 요청의 최종 상태를 반환하여 설정된 다중 포인트 VC에 파티를 추가합니다.

구문

void NdisCmAddPartyComplete(
  [in]           NDIS_STATUS         Status,
  [in]           NDIS_HANDLE         NdisPartyHandle,
  [in, optional] NDIS_HANDLE         CallMgrPartyContext,
  [in]           PCO_CALL_PARAMETERS CallParameters
);

매개 변수

[in] Status

호출 관리자의 추가 파티 작업의 최종 상태를 NDIS_STATUS_SUCCESS 또는 NDIS_STATUS_PENDING 제외한 모든 NDIS_STATUS_XXX 를 지정합니다.

[in] NdisPartyHandle

파티를 식별하는 핸들을 지정합니다. 이 핸들은 호출 관리자의 ProtocolCmAddParty 함수에 대한 입력이었습니다.

[in, optional] CallMgrPartyContext

추가 파티 작업이 성공한 경우 호출 관리자가 파티별 상태 정보를 유지 관리하는 호출자 할당 상주 컨텍스트 영역에 대한 핸들을 지정합니다. 그렇지 않으면 이 매개 변수는 무시되므로 NULL 일 수 있습니다.

[in] CallParameters

원래 클라이언트에서 제공한 파티가 추가될 호출 매개 변수를 포함하는 형식 CO_CALL_PARAMETERS 구조에 대한 포인터입니다.

반환 값

없음

설명

독립 실행형 호출 관리자의 ProtocolCmAddParty 함수가 NDIS_STATUS_PENDING 반환하는 경우 CM은 이후에 NdisCmAddPartyComplete 를 호출하여 클라이언트 및 NDIS에 성공적으로 또는 오류와 관계없이 다중 포인트 VC에 파티를 추가하려는 시도가 완료되었음을 알려야 합니다.

클라이언트가 다중 포인트 VC에 대해 이미 설정된 것과 일치하지 않는 CallParameters 에서 트래픽 매개 변수를 전달한 경우 호출 관리자의 디자이너는 네트워크 매체에 의해 부과된 제약 조건에 따라 이 조건을 처리하는 방법을 결정해야 합니다. 가능한 원인은 다음과 같습니다.

• 기본 네트워크 매체가 다중 포인트 VC에서 이 기능을 지원하는 경우 파티별 트래픽 매개 변수를 설정합니다.
• CM이 NDIS_STATUS_SUCCESS 사용하여 NdisCmAddPartyComplete를 호출하기 전에 원래 나가는 호출이 이루어졌을 때 클라이언트에서 제공한 트래픽 매개 변수를 VC에 대해 설정된 트래픽 매개 변수로 다시 설정합니다.
• CM이 NDIS_STATUS_SUCCESS 사용하여 NdisCmAddPartyComplete 를 호출하기 전에 VC에 대한 트래픽 매개 변수 및 현재 연결된 모든 파티의 트래픽 매개 변수를 클라이언트 제공 값으로 변경 합니다 .
• 파티를 추가하려는 클라이언트의 시도에 실패합니다. (이 대안은 암시적으로 클라이언트가 NdisClMakeCall 을 사용하여 다중 포인트 VC에 대한 트래픽 매개 변수를 설정하고 지정된 다중 포인트 VC에 대해 NdisClAddParty 에 대한 각 후속 호출에서 동일한 트래픽 매개 변수를 지정하도록 강제합니다.)

일부 연결 지향 미디어의 경우 트래픽 매개 변수는 본질적으로 VC당이며, 따라서 다중 포인트 VC의 모든 당사자에 대해 동일합니다.

CM이 상태를 NDIS_STATUS_SUCCESS 설정하면 NdisCmAddPartyComplete를 호출할 때 일반적으로 CM 할당 파티별 상태 영역에 대한 포인터인 명시적 핸들을 CallMgrPartyContext로 제공해야 합니다.

NdisCmAddPartyComplete를 호출하면 NDIS에서 클라이언트의 ProtocolClAddPartyComplete 함수를 호출합니다.

NDIS를 프로토콜 드라이버로 등록하는 독립 실행형 통화 관리자만 NdisCmAddPartyComplete를 호출할 수 있습니다. 통합 통화 관리 지원을 제공하는 연결 지향 미니포트 드라이버는 대신 NdisMCmAddPartyComplete 를 호출합니다.

요구 사항

지원되는 최소 클라이언트	Windows Vista에서 NDIS 6.0 및 NDIS 5.1 드라이버(NdisCmAddPartyComplete(NDIS 5.1) 참조)에 대해 지원됩니다. Windows XP에서 NDIS 5.1 드라이버(NdisCmAddPartyComplete(NDIS 5.1) 참조)에 대해 지원됩니다.
대상 플랫폼	데스크톱
머리글	ndis.h(Ndis.h 포함)
라이브러리	Ndis.lib
IRQL	<= DISPATCH_LEVEL
DDI 규정 준수 규칙	Irql_CallManager_Function(ndis)

참고 항목

CO_CALL_PARAMETERS

NdisAllocateFromNPagedLookasideList

NdisClAddParty

NdisMCmAddPartyComplete

ProtocolClAddPartyComplete

ProtocolCmAddParty