NdisMCmRegisterAddressFamilyEx 함수(ndis.h)

아티클
08/07/2023

NdisMCmRegisterAddressFamilyEx 함수는 MCM(미니포트 호출 관리자)과 CoNDIS 클라이언트 간의 통신을 위해 AF(주소 패밀리)를 등록합니다.

구문

NDIS_STATUS NdisMCmRegisterAddressFamilyEx(
  [in] NDIS_HANDLE        MiniportAdapterHandle,
  [in] PCO_ADDRESS_FAMILY AddressFamily
);

매개 변수

[in] MiniportAdapterHandle

미니포트 어댑터를 식별하는 NDIS 제공 핸들입니다. 이 핸들은 MCM의 입력 매개 변수입니다. MiniportInitializeEx 함수입니다.

[in] AddressFamily

MCM 드라이버가 지원하는 AF를 식별하는 CO_ADDRESS_FAMILY 구조체에 대한 포인터입니다.

포인터가 에 대한 입력 매개 변수가 됩니다. ProtocolCoAfRegisterNotify 는 이 MCM 드라이버에 바인딩된 모든 CoNDIS 클라이언트의 함수입니다.

반환 값

NdisMCmRegisterAddressFamilyEx 는 다음 중 어느 것을 반환할 수 있습니다.

반환 코드	설명
NDIS_STATUS_SUCCESS	AddressFamily 매개 변수가 지정한 AF에 대한 호출 관리자로 NDIS에 등록된 미니포트 드라이버이므로 NDIS는 ProtocolCoAfRegisterNotify 는 MCM 드라이버에 바인딩하는 모든 클라이언트의 함수입니다.
NDIS_STATUS_RESOURCES	NDIS가 충분한 메모리를 할당하거나 MCM 드라이버를 지정된 AF의 호출 관리자로 추적하는 데 사용하는 상태 정보를 초기화할 수 없으므로 요청된 작업이 실패했습니다.
NDIS_STATUS_FAILURE	NDIS는 다음 이유 중 하나로 인해 NdisMCmRegisterAddressFamilyEx에 대한 호출에 실패했습니다. 호출자가 연결 지향 미니포트 드라이버로 등록되지 않았습니다. 호출자가 지정된 미니포트 어댑터에 대해 중복 AF를 등록하려고 했습니다.

설명

를 호출하여 NDIS 미니포트 드라이버로 등록하는 NDIS MCM NdisMRegisterMiniportDriver 함수는 NdisMCmRegisterAddressFamilyEx 함수를 호출하여 AF를 등록해야 합니다. 독립 실행형 통화 관리자는 대신 을 호출해야 합니다. NdisCmRegisterAddressFamilyEx 함수입니다.

미니포트 어댑터에 대한 AF를 등록하려면 MCM이 MiniportInitializeEx 함수에서 NdisMCmRegisterAddressFamilyEx를 호출해야 합니다.

온보드 연결 지향 신호 지원이 있는 NIC(네트워크 인터페이스 카드)의 드라이버는 호출 관리 성능을 높이기 위해 MCM 드라이버로 등록할 수 있습니다. 드라이버가 MCM 드라이버로 등록되면 NIC 드라이버의 자체 통화 관리 지원을 사용하는 모든 독립 실행형 호출 관리자가 대체됩니다.

MCM 드라이버는 NIC가 완전히 작동하고 드라이버가 네트워크 I/O 작업을 완료할 수 있다고 판단한 후 NdisMCmRegisterAddressFamilyEx 를 호출합니다. 즉, 이러한 MCM은 자신을 호출 관리자로 등록하고 CoNDIS 클라이언트에 대한 특정 신호 서비스를 보급합니다.

MiniportInitializeEx가 호출 관리자로 성공적으로 등록된 컨트롤을 반환한 후 NDIS는 잠재적 클라이언트의 ProtocolBindAdapterEx 함수를 호출한 다음, ProtocolCoAfRegisterNotify 는 연결된 MCM 미니포트 어댑터에 자신을 바인딩하는 모든 클라이언트의 함수입니다. 그런 다음 이러한 클라이언트는 NDIS가 MCM의 ProtocolCmOpenAf 함수를 호출하도록 합니다.

MCM은 관리하는 단일 NIC에 대해 둘 이상의 AF를 지원할 수 있습니다. MCM 드라이버는 미니포트 어댑터에 등록하는 각 AF에 대해 NdisMCmRegisterAddressFamilyEx 를 한 번 호출해야 합니다. 하나의 MCM 드라이버만 지정된 미니포트 어댑터에 바인딩된 클라이언트에 대해 특정 유형의 AF를 지원할 수 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	NDIS 6.0 이상에서 지원됩니다.
대상 플랫폼	데스크톱
머리글	ndis.h(Ndis.h 포함)
라이브러리	Ndis.lib
IRQL	PASSIVE_LEVEL
DDI 규정 준수 규칙	Irql_MCM_Function(ndis)