NDK_FN_CONNECT_WITH_SHARED_ENDPOINT 콜백 함수(ndkpi.h)

아티클
02/29/2024

NdkConnectWithSharedEndpoint(NDK_FN_CONNECT_WITH_SHARED_ENDPOINT) 함수는 공유 로컬 주소에서 원격 주소로 NDK 연결 요청을 시작합니다.

구문

NDK_FN_CONNECT_WITH_SHARED_ENDPOINT NdkFnConnectWithSharedEndpoint;

NTSTATUS NdkFnConnectWithSharedEndpoint(
  [in]                                      NDK_CONNECTOR *pNdkConnector,
  [in]                                      NDK_QP *pNdkQp,
  [in]                                      NDK_SHARED_ENDPOINT *pNdkSharedEndpoint,
                                            const PSOCKADDR pDestAddress,
  [in]                                      ULONG DestAddressLength,
  [in]                                      ULONG InboundReadLimit,
  [in]                                      ULONG OutboundReadLimit,
  [_In_reads_bytes_opt_(PrivateDataLength)] const PVOID pPrivateData,
  [in]                                      ULONG PrivateDataLength,
  [in]                                      NDK_FN_REQUEST_COMPLETION RequestCompletion,
  [in, optional]                            PVOID RequestContext
)
{...}

매개 변수

[in] pNdkConnector

NDK 커넥터 개체(NDK_CONNECTOR)에 대한 포인터입니다.

[in] pNdkQp

연결과 연결할 NDK QP(큐 쌍) 개체(NDK_QP)에 대한 포인터입니다.

[in] pNdkSharedEndpoint

연결의 로컬 주소를 결정하는 NDK 공유 엔드포인트 개체(NDK_SHARED_ENDPOINT)에 대한 포인터입니다.

pDestAddress

대상 주소입니다. AF_INET 또는 AF_INET6 pDestAddress 의 경우 대상 IP 주소 및 대상 ND 포트입니다.

[in] DestAddressLength

pDestAddress. 매개 변수의 대상 주소 데이터의 크기(바이트)입니다.

[in] InboundReadLimit

소비자가 제공한 QP에서 허용할 들어오는 진행 중인 읽기 작업의 최대 수입니다. 기본 공급자가 NDK_ADAPTER_INFO 구조에서 더 낮은 MaxInboundReadLimit 값을 갖는 경우 공급자는 소비자가 제공한 값을 공급자 최대값으로 제한합니다. 피어의 OutboundReadLimit 값이 낮으면 공급자는 해당 값을 유효한 InboundReadLimit로 사용합니다. 소비자는 NdkGetConnectionData 함수(NDK_FN_GET_CONNECTION_DATA)를 호출하여 유효한 InboundReadLimit를 검색할 수 있습니다.

[in] OutboundReadLimit

소비자가 제공한 QP에서 허용할 나가는 진행 중인 읽기 작업의 최대 수입니다. 기본 공급자가 NDK_ADAPTER_INFO 구조에서 MaxOutboundReadLimit 값이 낮으면 공급자는 제공된 소비자 값을 공급자 최대값으로 제한합니다. 피어에 InboundReadLimit가 더 낮은 경우 공급자는 해당 값을 유효한 OutboundReadLimit로 사용합니다. 소비자는 NdkGetConnectionData 함수(NDK_FN_GET_CONNECTION_DATA)를 호출하여 유효한 OutboundReadLimit를 검색할 수 있습니다.

[_In_reads_bytes_opt_(PrivateDataLength)] pPrivateData

연결 요청과 함께 전송되는 프라이빗 데이터에 대한 포인터입니다.

[in] PrivateDataLength

pPrivateData 매개 변수에 제공되는 프라이빗 데이터의 길이(바이트)입니다.

[in] RequestCompletion

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

[in, optional] RequestContext

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

반환 값

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

반환 코드	설명
STATUS_SUCCESS	연결 요청이 성공적으로 완료되었습니다.
STATUS_PENDING	작업이 보류 중이며 나중에 완료됩니다. 드라이버는 지정된 RequestCompletion (NDK_FN_REQUEST_COMPLETION) 함수를 호출하여 보류 중인 작업을 완료합니다.
STATUS_INSUFFICIENT_RESOURCES	리소스가 부족하여 요청이 실패했습니다. 중요 이 상태 코드에서는 요청이 인라인뿐만 아니라 비동기적으로 실패할 수 있습니다.
STATUS_NETWORK_UNREACHABLE	원격 네트워크에 연결할 수 없어 요청이 실패했습니다. 연결 시도를 다시 시도할 수 있습니다. 중요 이 상태 코드에서는 요청이 인라인뿐만 아니라 비동기적으로 실패할 수 있습니다.
STATUS_HOST_UNREACHABLE	원격 시스템에 연결할 수 없어 요청이 실패했습니다. 연결 시도를 다시 시도할 수 있습니다. 중요 이 상태 코드에서는 요청이 인라인뿐만 아니라 비동기적으로 실패할 수 있습니다.
STATUS_CONNECTION_REFUSED	원격 시스템에서 연결 요청을 거부했기 때문에 요청이 실패했습니다. 이는 수신기 부족, 백로그 제한 또는 피어가 연결 요청을 적극적으로 거부하기 때문일 수 있습니다. 연결 시도를 다시 시도할 수 있습니다. 중요 이 상태 코드에서는 요청이 인라인뿐만 아니라 비동기적으로 실패할 수 있습니다.
STATUS_IO_TIMEOUT	연결 요청 시간이 초과되어 요청이 실패했습니다. 연결 시도를 다시 시도할 수 있습니다. 시간 제한 값은 네트워크 다이렉트 공급자가 해당 네트워크 특성과 일치하도록 선택됩니다. 중요 이 상태 코드에서는 요청이 인라인뿐만 아니라 비동기적으로 실패할 수 있습니다.
STATUS_ADDRESS_ALREADY_EXISTS	로컬 주소, 로컬 포트, 원격 주소 및 원격 포트의 조합에 대한 연결이 이미 있으므로 요청이 실패했습니다. 중요 이 상태 코드에서는 요청이 인라인뿐만 아니라 비동기적으로 실패할 수 있습니다.
기타 상태 코드	오류가 발생했습니다.

설명

NdkConnectWithSharedEndpoint 는 공유 로컬 주소에서 특정 원격 주소로의 연결 요청을 시작합니다. NdkConnectWithSharedEndpoint 를 사용하면 NDK 소비자가 연결의 대상 주소가 다를 때 많은 나가는 연결에 동일한 로컬 주소(예: 10.1.1.1:9999)를 사용할 수 있습니다.

요구 사항

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