NdisMCmAddPartyComplete 매크로(ndis.h)

아티클
08/07/2023

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

구문

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

매개 변수

_S_

MCM 드라이버의 추가 파티 작업의 최종 상태 지정합니다(NDIS_STATUS_SUCCESS 또는 NDIS_STATUS_PENDING 제외한 모든 NDIS_STATUS_XXX).

_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에서 파티별 트래픽 매개 변수를 지원하지 않는 경우 클라이언트가 해당 VC에 대해 이미 설정된 트래픽 매개 변수와 일치하지 않는 CallParameters 에서 사양이 있는 파티를 추가하려고 할 때마다 MCM 드라이버는 다음 중 하나를 수행할 수 있습니다.

해당 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 드라이버(NdisMCmAddPartyComplete(NDIS 5.1) 참조)에 대해 지원됩니다.
대상 플랫폼	데스크톱
머리글	ndis.h(Ndis.h 포함)
IRQL	<= DISPATCH_LEVEL
DDI 규정 준수 규칙	Irql_MCM_Function(ndis)