NdisMCmRegisterSapComplete 매크로(ndis.h)

아티클
08/07/2023

NdisMCmRegisterSapComplete는 MCM 드라이버가 클라이언트 요청의 최종 상태 반환합니다.

ProtocolCmRegisterSap 함수는 이전에 SAP를 등록하기 위해 NDIS_STATUS_PENDING 반환했습니다.

구문

void NdisMCmRegisterSapComplete(
   _S_,
   _H_,
   _C_
);

매개 변수

_S_

NDIS_STATUS_SUCCESS 또는 호출자가 결정한 NDIS_STATUS_XXX(NDIS_STATUS_PENDING 제외)를 등록하기 위한 클라이언트의 원래 요청에 대한 최종 상태 지정합니다.

_H_

등록에 성공한 경우 SAP에 대한 NDIS 제공 핸들을 지정합니다. 호출 관리자는 이 핸들을 ProtocolCmRegisterSap 함수에 대한 입력 매개 변수로 획득했습니다.

_C_

등록에 성공하면 MCM 드라이버가 이 SAP의 상태를 유지하는 호출자 제공 상주 컨텍스트 영역에 대한 핸들을 지정합니다. 이 경우 NDIS는 이 SAP와 관련된 모든 후속 호출에서 이 핸들을 MCM 드라이버에 다시 전달합니다. Status가 NDIS_STATUS_SUCCESS 이외의 항목으로 설정된 경우 NDIS는 이 매개 변수를 무시합니다.

반환 값

없음

설명

MCM 드라이버는 ProtocolCmRegisterSap 함수가 지정된 NdisSapHandle 로 호출되었을 때 NDIS_STATUS_PENDING 반환된 경우 NdisMCmRegisterSapComplete를 호출해야 합니다. NdisMCmRegisterSapComplete를 호출하면 NDIS가 클라이언트의 를 호출합니다. ProtocolClRegisterSapComplete 함수입니다.

MCM 드라이버가 상태를 NDIS_STATUS_SUCCESS 이외의 항목으로 설정하는 경우 NdisMCmRegisterSapComplete가 컨트롤을 반환할 때 NdisSapHandle이 잘못된 것으로 간주해야 합니다. SAP 등록에 실패하면 CM은 이미 할당된 SAP별 컨텍스트 영역(있는 경우)을 해제하거나 다시 사용할 수 있습니다. MCM 드라이버가 등록에 실패하는 경우 NDIS는 SAP에 대한 컨텍스트도 해제합니다.

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

요구 사항

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