NdisMCoActivateVcComplete 함수(ndis.h)

아티클
08/07/2023

NdisMCoActivateVcComplete 는 미니포트 드라이버가 이전에 NDIS_STATUS_PENDING 반환한 CM 시작 activate-VC 요청 처리를 완료했음을 NDIS 및 호출 관리자에게 알려줍니다.

구문

void NdisMCoActivateVcComplete(
  [in] NDIS_STATUS         Status,
  [in] NDIS_HANDLE         NdisVcHandle,
  [in] PCO_CALL_PARAMETERS CallParameters
);

매개 변수

[in] Status

NDIS_STATUS_PENDING 제외한 NDIS_STATUS_SUCCESS 또는 NDIS_STATUS_ XXX일 수 있는 activate-VC 작업의 최종 상태 지정합니다.

[in] NdisVcHandle

VC를 식별하는 핸들을 지정합니다. 호출자는 입력 매개 변수로 전달된 MiniportVcContext 에 의해 지정된 VC별 상태에서 이 핸들을 가져옵니다. MiniportCoActivateVc 함수입니다.

[in] CallParameters

VC 활성화에 대한 호출 및 미디어 매개 변수를 지정하는 호출 관리자에서 제공하는 CO_CALL_PARAMETERS 형식의 구조에 대한 포인터입니다.

반환 값

없음

설명

MiniportCoActivateVc 함수가 이전에 지정된 NdisVcHandle 로 식별된 VC를 활성화하거나 다시 활성화하라는 요청에 대한 응답으로 NDIS_STATUS_PENDING 반환한 경우 연결 지향 미니포트 드라이버는 NdisMCoActivateVcComplete를 호출해야 합니다. NdisCmActivateVc를 호출하여 VC 활성화를 시작한 호출 관리자는 미니포트 드라이버가 NdisMCoActivateVcComplete를 호출할 때까지 제공된 호출 매개 변수를 사용하여 VC에 대한 전송을 수행할 수 있는지 여부를 NDIS 또는 해당 클라이언트에 알릴 수 없습니다.

미니포트 드라이버가 CM 제공 호출 매개 변수를 사용할 수 없음을 발견하면 NdisMCoActivateVcComplete를 호출할 때 VC 활성화에 실패합니다. VC의 초기 활성화에 실패하면 VC를 만든 프로토콜이 중단될 수 있습니다. 미니포트 드라이버가 새 호출 매개 변수를 사용하여 설정된 VC를 다시 활성화하라는 요청에 실패하는 경우 해당 VC에 대해 설정된 원래 호출 매개 변수를 복원해야 합니다. 네트워크 매체의 특성에 따라 미니포트 드라이버는 NdisMCoActivateVcComplete를 호출하기 전에 라운드업 및/또는 라운드다운 플래그가 설정된 경우 미디어 매개 변수를 수정할 수 있습니다.

NdisMCoActivateVcComplete를 호출하면 NDIS가원래 VC 활성화를 요청한 호출 관리자의 ProtocolCmActivateVcComplete 함수입니다.

요구 사항

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