NdisMCmOpenAddressFamilyComplete 매크로(ndis.h)

  • 아티클

NdisMCmOpenAddressFamilyComplete는 MCM 드라이버의 ProtocolCmOpenAf 함수가 NDIS_STATUS_PENDING 반환한 클라이언트 요청의 최종 상태 반환하여 MCM 드라이버의 주소 패밀리를 엽니다.

구문

void NdisMCmOpenAddressFamilyComplete(
   _S_,
   _H_,
   _C_
);

매개 변수

_S_

NDIS_STATUS_PENDING 제외한 NDIS_STATUS_SUCCESS 또는 호출자가 결정한 NDIS_STATUS_ XXX를 여는 클라이언트 요청의 최종 상태 지정합니다.

_H_

NDIS_STATUS_PENDING 반환한 MCM 드라이버의 ProtocolCmOpenAf 함수에 입력된 NDIS 제공 핸들을 지정합니다.

_C_

호출자가 할당한 상주 컨텍스트 영역에 대한 핸들을 지정합니다. MCM 드라이버는 열기가 성공한 경우 NdisAfHandle을 포함하여 이 클라이언트의 주소 패밀리 열기에 대한 상태를 유지 관리합니다. 그렇지 않으면 NDIS는 이 매개 변수를 무시합니다.

반환 값

없음

설명

MCM 드라이버는 ProtocolCmOpenAf 함수가 이전에 지정된 NdisAfHandle 에 대해 NDIS_STATUS_PENDING 반환한 경우 NdisMCmOpenAddressFamilyComplete를 호출해야 합니다. NdisClOpenAddressFamilyEx를 호출하여 보류 중인 open-AF 작업을 시작한 클라이언트는 NdisMCmOpenAddressFamilyComplete가 해당 클라이언트에 대한 호출을 발생시킬 때까지 동일한 바인딩에서 추가 연결 지향 작업을 수행할 수 없습니다. ProtocolClOpenAfCompleteEx 함수입니다.

NdisMCmOpenAddressFamilyComplete의 호출자가 상태를 NDIS_STATUS_SUCCESS 설정하는 경우 NDIS는 이후에 지정된 CallMgrAfContext 핸들을 입력 매개 변수로 전달하여 클라이언트가 AF를 닫을 때까지 클라이언트의 주소 패밀리 열기와 관련된 모든 MCM 드라이버 제공 ProtocolCmXxx 및 ProtocolCoXxx 함수에 전달합니다. MCM 드라이버는 실패 상태 NdisMCmOpenAddressFamilyComplete에 전달하기 전에 할당된 AF 컨텍스트 영역을 해제하거나 다시 사용해야 합니다.

성공적인 열기를 위해 NDIS에서 제공하는 NdisAfHandle 은 열린 AF에 대한 MCM 드라이버와 클라이언트 간의 연결을 나타냅니다. 두 NDIS 드라이버는 이 핸들이 필수 매개 변수인 NdisCl/Co/MCm/MCoXxx 함수에 대한 후속 호출에서 전달되고 수정되지 않고 해석되지 않는 불투명 변수로 NdisAfHandle 을 처리해야 합니다. 실패한 열기의 경우 MCM 드라이버는 NdisMCmOpenAddressFamilyComplete가 컨트롤을 반환할 때 NdisAfHandle이 잘못된 것으로 간주해야 합니다.

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

요구 사항

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

추가 정보

NdisAllocateFromNPagedLookasideList

NdisClOpenAddressFamilyEx

NdisCmOpenAddressFamilyComplete

ProtocolClOpenAfCompleteEx

ProtocolCmOpenAf