NdisMCmRegisterSapComplete 매크로(ndis.h)
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) |