NDK_FN_CREATE_SHARED_ENDPOINT 콜백 함수(ndkpi.h)

  • 아티클

NdkCreateSharedEndpoint(NDK_FN_CREATE_SHARED_ENDPOINT) 함수는 NDK 공유 엔드포인트를 만듭니다.

구문

NDK_FN_CREATE_SHARED_ENDPOINT NdkFnCreateSharedEndpoint;

NTSTATUS NdkFnCreateSharedEndpoint(
  [in]           NDK_ADAPTER *pNdkAdapter,
                 const PSOCKADDR pAddress,
  [in]           ULONG AddressLength,
  [in]           NDK_FN_CREATE_COMPLETION CreateCompletion,
  [in, optional] PVOID RequestContext,
                 NDK_SHARED_ENDPOINT **ppNdkSharedEndpoint
)
{...}

매개 변수

[in] pNdkAdapter

NDK 어댑터 개체(NDK_ADAPTER)에 대한 포인터입니다.

pAddress

나가는 연결을 시작하는 데 사용할 로컬 주소입니다. AF_INET 또는 AF_INET6 pAddress 의 경우 로컬 IP 주소와 로컬 ND 포트가 포함됩니다.

[in] AddressLength

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

[in] CreateCompletion

NDK 개체 만들기를 완료하는 NdkCreateCompletion (NDK_FN_CREATE_COMPLETION) 함수에 대한 포인터입니다.

[in, optional] RequestContext

NDK 공급자가 CreateCompletion 매개 변수에 지정된 NdkCreateCompletion 함수로 다시 전달하는 컨텍스트 값입니다.

ppNdkSharedEndpoint

STATUS_PENDING 반환하지 않고 요청이 성공하면 생성된 공유 엔드포인트 개체(NDK_SHARED_ENDPOINT)에 대한 포인터가 이 위치에 반환됩니다. 요청이 STATUS_PENDING 반환하는 경우 이 매개 변수는 무시되고 CreateCompletion 매개 변수에 지정된 콜백과 함께 생성된 개체가 반환됩니다.

반환 값

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

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

설명

NdkCreateSharedEndpoint 함수는 다른 원격 주소로 향하는 여러 나가는 연결의 로컬 주소로 사용할 NDK 공유 엔드포인트를 만듭니다. 이는 수신기 개체가 나타내는 동일한 로컬 주소에 여러 개의 들어오는 연결을 갖는 것과 유사합니다.

함수가 STATUS_SUCCESS 반환하면 생성된 개체가 ppNdkSharedEndpoint 매개 변수에 반환됩니다. NdkCreateSharedEndpoint가 STATUS_PENDING 반환하는 경우 CreateCompletion 매개 변수에 지정된 NdkCreateCompletion(NDK_FN_CREATE_COMPLETION) 함수에 의해 생성된 개체가 반환됩니다.

요구 사항

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

추가 정보

NDKPI 개체 수명 요구 사항

NDK_ADAPTER

NDK_ADAPTER_DISPATCH

NDK_FN_CREATE_COMPLETION

NDK_SHARED_ENDPOINT