NdisMAllocatePort 함수(ndis.h)

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

구문

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

매개 변수

NdisMiniportHandle

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

[in, out] PortCharacteristics

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

반환 값

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

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

설명

NdisMAllocatePort 함수는 미니포트 어댑터와 연결된 포트에 대한 리소스 및 포트 번호를 할당합니다. 미니포트 드라이버가 포트에 대한 PnP(NetEventPortActivation Plug and Play) 이벤트를 실행하기 전까지는 포트가 활성화되지 않습니다.

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

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

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

요구 사항

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

참고 항목

NDIS 포트 할당

MiniportInitializeEx

NDIS_PORT_CHARACTERISTICS

NdisMFreePort

OID_GEN_ENUMERATE_PORTS