NdisMCmDeleteVc 함수(ndis.h)

아티클
08/07/2023

NdisMCmDeleteVc 는 호출자가 만든 VC를 삭제합니다.

구문

NDIS_STATUS NdisMCmDeleteVc(
  [in] NDIS_HANDLE NdisVcHandle
);

매개 변수

[in] NdisVcHandle

삭제할 VC를 식별하는 핸들을 지정합니다. 호출자는 원래 NdisMCmCreateVc에서 이 핸들을 얻었습니다.

반환 값

NdisMCmDeleteVc 는 다음 중 하나를 반환할 수 있습니다.

반환 코드	설명
NDIS_STATUS_SUCCESS	NDIS가 VC를 삭제했습니다.
NDIS_STATUS_NOT_ACCEPTED	VC는 여전히 활성 상태이므로 삭제할 수 없습니다.

설명

MCM 드라이버가 NdisMCmDeleteVc를 호출하는 경우 지정된 VC에 대한 미해결 호출이 없어야 하며 해당 VC가 비활성화되어야 합니다. 이러한 요구 사항을 충족하기 위해 MCM 드라이버가 이미 지정된 NdisVcHandle을 사용하여 NdisMCmDeactivateVc를 성공적으로 호출했음을 의미합니다.

특정 VC를 만든 드라이버만 해당 VC를 삭제할 수 있습니다. NdisMCmDeleteVc를 호출하면 NDIS에서 호출자가 NdisVcHandle 을 공유하는 클라이언트의 ProtocolCoDeleteVc 함수를 호출합니다.

NdisMCmDeleteVc가 컨트롤을 반환하면 NdisVcHandle이 더 이상 유효하지 않습니다. MCM 드라이버는 할당된 리소스를 해제하여 삭제된 VC에 대한 상태를 유지 관리하거나 NdisMCmCreateVc를 호출한 후 후속 수신 호출 알림에서 다시 사용할 수 있도록 준비할 수 있습니다.

드라이버 작성기는 MCM 드라이버에 발신 및 수신 호출에 대한 연결을 해제하는 컨텍스트에서 드라이버가 호출하는 (내부) MiniportCoDeleteVc 함수가 있는지 여부를 결정합니다.

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

요구 사항

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