NdisMCmAddPartyComplete 매크로(ndis.h)

NdisMCmAddPartyComplete 는 이전에 MCM 드라이버가 NDIS_STATUS_PENDING 반환한 클라이언트 요청의 최종 상태를 반환하여 설정된 멀티포인트 VC에 파티를 추가합니다.

구문

void NdisMCmAddPartyComplete(
   _S_,
   _H_,
   _C_,
   _P_
);

매개 변수

_S_

NDIS_STATUS_SUCCESS 또는 NDIS_STATUS_XXXexcept NDIS_STATUS_PENDING MCM 드라이버의 추가 파티 작업의 최종 상태를 지정합니다.

_H_

파티를 식별하는 핸들을 지정합니다. MCM 드라이버는 ProtocolCmAddParty 함수에 대한 입력 매개 변수로 이 핸들을 얻었습니다.

_C_

추가 파티 작업이 성공한 경우 MCM 드라이버가 파티별 상태 정보를 유지 관리하는 호출자 할당 상주 컨텍스트 영역에 대한 핸들을 지정합니다. 그렇지 않으면 Status가 NDIS_STATUS_SUCCESS 이외의 다른 매개 변수인 경우 NDIS에서 무시되기 때문에 이 매개 변수는 NULL일 수 있습니다.

_P_

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

반환 값

없음

설명

MCM 드라이버의 ProtocolCmAddParty 함수가 NDIS_STATUS_PENDING 반환하는 경우 드라이버는 이후에 NdisMCmAddPartyComplete 를 호출하여 클라이언트 및 NDIS에 성공적으로 또는 MCM 드라이버에서 결정된 오류 상태와 관계없이 다중 지점 VC에 파티를 추가하려는 시도가 완료되었음을 알려야 합니다.

기본 네트워크 매체는 클라이언트가 다중 지점 VC에서 파티별 트래픽 매개 변수를 지정할 수 있는지 여부를 결정합니다.

기본 네트워크 매체가 다중 지점 VC에서 파티별 트래픽 매개 변수를 지원하지 않는 경우 MCM 드라이버는 클라이언트가 해당 VC에 대해 이미 설정된 트래픽 매개 변수와 일치하지 않는 CallParameters 에서 사양이 있는 파티를 추가하려고 할 때마다 다음 중 하나를 수행할 수 있습니다.

  • 해당 VC에 파티가 성공적으로 추가되면 트래픽 매개 변수를 멀티포인트 VC에 대해 이미 설정된 매개 변수로 다시 설정합니다.
  • 새 파티가 성공적으로 추가되면 VC에 이미 있는 모든 당사자의 트래픽 매개 변수를 변경합니다.
  • 새 파티 추가 요청을 거부합니다. (이 대안은 암시적으로 클라이언트가 NdisClMakeCall 을 사용하여 다중 포인트 VC에 대한 트래픽 매개 변수를 설정하고 지정된 다중 포인트 VC에 대한 NdisClAddParty 에 대한 각 후속 호출에서 동일한 트래픽 매개 변수를 지정하도록 강제합니다.)
MCM 드라이버가 상태를 NDIS_STATUS_SUCCESS 설정하면 NdisMCmAddPartyComplete를 호출할 때 CallMgrPartyContext와 같이 일반적으로 드라이버 할당 파티별 상태 영역에 대한 포인터인 명시적 핸들을 제공해야 합니다.

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

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

요구 사항

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

참고 항목

CO_CALL_PARAMETERS

NdisAllocateFromNPagedLookasideList

NdisClAddParty

NdisCmAddPartyComplete

NdisMCmDropPartyComplete

ProtocolClAddPartyComplete

ProtocolCmAddParty