NdisCmOpenAddressFamilyComplete 함수(ndis.h)

NdisCmOpenAddressFamilyComplete 는 호출 관리자가 해당 클라이언트의 원래 open-AF 요청에 대한 응답으로 NDIS_STATUS_PENDING 반환한 후 독립 실행형 호출 관리자가 특정 클라이언트에 대해 지정된 AF를 연 최종 상태를 반환합니다.

구문

void NdisCmOpenAddressFamilyComplete(
  [in] NDIS_STATUS Status,
  [in] NDIS_HANDLE NdisAfHandle,
  [in] NDIS_HANDLE CallMgrAfContext
);

매개 변수

[in] Status

NDIS_STATUS_PENDING 제외하고 NDIS_STATUS_SUCCESS 또는 CM으로 결정된 오류 NDIS_STATUS_ XXX 에서 open-AF 작업의 최종 상태를 지정합니다.

[in] NdisAfHandle

NDIS_STATUS_PENDING 반환한 호출 관리자의 ProtocolCmOpenAf 함수에 입력된 NDIS 제공 핸들을 지정합니다.

[in] CallMgrAfContext

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

반환 값

없음

설명

독립 실행형 호출 관리자는 ProtocolCmOpenAf 함수가 이전에 지정된 NdisAfHandle에 대한 NDIS_STATUS_PENDING 반환한 경우 NdisCmOpenAddressFamilyComplete를 호출해야 합니다. NdisClOpenAddressFamilyEx를 호출하여 보류 중인 open-AF 작업을 시작한 클라이언트는 NdisCmOpenAddressFamilyComplete에서 해당 클라이언트의 ProtocolClOpenAfCompleteEx 함수를 호출할 때까지 동일한 바인딩에서 추가 연결 지향 작업을 수행할 수 없습니다.

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

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

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

요구 사항

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

참고 항목

NdisAllocateFromNPagedLookasideList

NdisClOpenAddressFamilyEx

NdisMCmOpenAddressFamilyComplete

ProtocolClOpenAfCompleteEx

ProtocolCmOpenAf