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가 포트에 대한 리소스를 성공적으로 할당했습니다. |
|
NDIS에서 포트에 대한 리소스를 할당할 수 없습니다. |
|
연결된 미니포트 어댑터가 닫혀 포트 할당에 실패했습니다. |
|
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 |