다음을 통해 공유

NDK_FN_LISTEN 콜백 함수(ndkpi.h)

  • 아티클

NdkListen(NDK_FN_LISTEN) 함수는 NDK 수신기 개체를 수신 모드로 전환합니다.

구문

NDK_FN_LISTEN NdkFnListen;

NTSTATUS NdkFnListen(
  [in]           NDK_LISTENER *pNdkListener,
                 const PSOCKADDR pAddress,
  [in]           ULONG AddressLength,
  [in]           NDK_FN_REQUEST_COMPLETION RequestCompletion,
  [in, optional] PVOID RequestContext
)
{...}

매개 변수

[in] pNdkListener

NDK 수신기 개체(NDK_LISTENER)에 대한 포인터입니다.

pAddress

수신 대기할 로컬 주소입니다. AF_INET 또는 AF_INET6 pAddress 의 경우 로컬 IP 주소와 로컬 ND 포트가 포함됩니다.

[in] AddressLength

pAddress 매개 변수의 로컬 주소 데이터의 크기(바이트)입니다.

[in] RequestCompletion

요청 완료 콜백 루틴 NdkRequestCompletion (NDK_FN_REQUEST_COMPLETION)에 대한 포인터입니다.

[in, optional] RequestContext

RequestCompletion 매개 변수에 지정된 콜백 함수의 Context 매개 변수에 전달할 컨텍스트 값입니다.

반환 값

NdkListen 함수는 다음 NTSTATUS 코드 중 하나를 반환합니다.

반환 코드 설명
STATUS_SUCCESS
 수신 대기 요청이 성공했습니다.
STATUS_PENDING
 작업이 보류 중이며 나중에 완료됩니다. 드라이버는 지정된 requestCompletion (NDK_FN_REQUEST_COMPLETION) 함수를 호출하여 보류 중인 작업을 완료합니다.
STATUS_INSUFFICIENT_RESOURCES
 리소스 부족으로 인해 요청이 실패했습니다.
중요 요청은 이 상태 코드와 비동기적으로도 인라인으로 실패할 수 있습니다.
 
STATUS_SHARING_VIOLATION
 지정된 로컬 주소가 이미 사용 중이므로 요청이 실패했습니다.
중요 요청은 이 상태 코드와 비동기적으로도 인라인으로 실패할 수 있습니다.
 
STATUS_INVALID_ADDRESS
 지정된 로컬 주소가 어댑터의 유효한 주소가 아니므로 요청이 실패했습니다.
중요 요청은 이 상태 코드와 비동기적으로도 인라인으로 실패할 수 있습니다.
 
STATUS_TOO_MANY_ADDRESSES
 소비자가 로컬 포트 번호를 0으로 지정하고 네트워크 직접 공급자가 임시 포트 공간(포트 49152-65535)에서 포트를 할당할 수 없기 때문에 요청이 실패했습니다.
기타 상태 코드
 오류가 발생했습니다.

설명

NdkListen 은 수신기 개체를 지정된 로컬 주소의 수신 모드로 전환합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 지원되지 않음, NDIS 6.30 이상에서 지원됨
지원되는 최소 서버 Windows Server 2012
대상 플랫폼 Windows
헤더 ndkpi.h(Ndkpi.h 포함)
IRQL <=DISPATCH_LEVEL

추가 정보

NDKPI 개체 수명 요구 사항

NDK_FN_REQUEST_COMPLETION

NDK_LISTENER