NdisMAllocatePort 함수(ndis.h)

NdisMAllocatePort 함수는 미니포트 어댑터와 연결된 NDIS 포트를 할당합니다.

구문

NDIS_STATUS NdisMAllocatePort(
            NDIS_HANDLE                NdisMiniportHandle,
  [in, out] PNDIS_PORT_CHARACTERISTICS PortCharacteristics
);

매개 변수

NdisMiniportHandle

NDIS가 의 MiniportAdapterHandle 매개 변수에 전달한 미니포트 어댑터 핸들 MiniportInitializeEx 함수입니다.

[in, out] PortCharacteristics

에 대한 포인터 NDIS_PORT_CHARACTERISTICS 포트의 특성을 정의하는 구조체입니다.

반환 값

NdisMAllocatePort 는 다음 값 중 하나를 반환할 수 있습니다.

반환 코드	설명
NDIS_STATUS_SUCCESS	NDIS가 포트에 대한 리소스를 성공적으로 할당했습니다.
NDIS_STATUS_RESOURCES	NDIS에서 포트에 대한 리소스를 할당할 수 없습니다.
NDIS_STATUS_CLOSING	연결된 미니포트 어댑터가 닫혀 포트 할당에 실패했습니다.
NDIS_STATUS_INVALID_DATA	PortCharacteristics 매개 변수에 제공된 데이터가 잘못되었습니다.

설명

NdisMAllocatePort 함수는 미니포트 어댑터와 연결된 포트에 대한 리소스 및 포트 번호를 할당합니다. 포트는 미니포트 드라이버가 포트에 대한 NetEventPortActivation 플러그 앤 플레이(PnP) 이벤트를 발급할 때까지 활성화되지 않습니다.

미니포트 드라이버가 포트를 활성화하면 NDIS는 오버리싱 드라이버에 대한 PnP 알림을 생성합니다. 오버레이 드라이버 또는 사용자 모드 애플리케이션이 미니포트 어댑터의 포트를 열거하기 위해 OID_GEN_ENUMERATE_PORTS OID를 발급하는 경우 NDIS는 포트 목록에 비활성 할당 포트를 포함하지 않습니다.

NdisMAllocatePort가 성공적으로 반환되면 의 PortNumber 멤버입니다.PortCharacteristics 매개 변수가 지정하는 NDIS_PORT_CHARACTERISTICS 구조체는 NDIS가 포트에 할당한 포트 번호로 설정됩니다.

포트가 더 이상 필요하지 않으면 미니포트 드라이버는 NdisMFreePort 함수를 호출하여 포트를 해제해야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	NDIS 6.0 이상에서 지원됩니다.
대상 플랫폼	유니버설
헤더	ndis.h(Ndis.h 포함)
라이브러리	Ndis.lib
IRQL	<= DISPATCH_LEVEL

추가 정보

NDIS 포트 할당

MiniportInitializeEx

NDIS_PORT_CHARACTERISTICS

NdisMFreePort

OID_GEN_ENUMERATE_PORTS