NdisCmAddPartyComplete 함수(ndis.h)

아티클
08/07/2023

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)