NDK_FN_INITIALIZE_FAST_REGISTER_MR 콜백 함수(ndkpi.h)

  • 아티클

NdkInitializeFastRegisterMr(NDK_FN_INITIALIZE_FAST_REGISTER_MR) 함수는 빠른 등록을 위해 MR(NDK 메모리 영역)을 초기화합니다.

구문

NDK_FN_INITIALIZE_FAST_REGISTER_MR NdkFnInitializeFastRegisterMr;

NTSTATUS NdkFnInitializeFastRegisterMr(
  [in]           NDK_MR *pNdkMr,
  [in]           ULONG AdapterPageCount,
  [in]           BOOLEAN RemoteAccess,
  [in]           NDK_FN_REQUEST_COMPLETION RequestCompletion,
  [in, optional] PVOID RequestContext
)
{...}

매개 변수

[in] pNdkMr

MR(NDK 메모리 영역) 개체(NDK_MR)에 대한 포인터입니다.

[in] AdapterPageCount

어댑터 페이지 수가 같거나 적은 작업 요청을 빠르게 등록할 수 있도록 이 MR에서 지원할 최대 어댑터 페이지 수입니다.

[in] RemoteAccess

원격 액세스를 위해 MR를 초기화해야 하는지 여부를 나타내는 BOOLEAN 값입니다. 소비자가 NdkFastRegister(NDK_FN_FAST_REGISTER) 함수를 사용하여 원격 액세스를 요청하는 경우 NDK 소비자는 RemoteAccess를 TRUE로 설정해야 합니다.

[in] RequestCompletion

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

[in, optional] RequestContext

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

반환 값

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

반환 코드 설명
STATUS_SUCCESS
 초기화가 성공적으로 완료되었습니다.
STATUS_PENDING
 작업이 보류 중이며 나중에 완료됩니다. 드라이버는 지정된 RequestCompletion (NDK_FN_REQUEST_COMPLETION) 함수를 호출하여 보류 중인 작업을 완료합니다.
STATUS_IMPLEMENTATION_LIMIT
 어댑터가 요청된 AdapterPageCount를 지원하지 않으므로 요청이 실패했습니다.
기타 상태 코드
 오류가 발생했습니다.

설명

NdkInitializeFastRegisterMr은 빠른 등록을 위해 MR를 초기화합니다. NDK_MR 개체는 NdkCreateMr(NDK_FN_CREATE_MR) 함수의 FastRegister 매개 변수를 TRUE로 설정하여 만들어야 합니다.

NdkInitializeFastRegisterMr을 병렬로 또는 하나씩 여러 번 호출할 수 있습니다.

NdkInitializeFastRegisterMr이 반환되면 빠른 레지스터 작업 요청을 큐 쌍(QP)에 게시할 수 있습니다.

요구 사항

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

추가 정보

NDKPI 개체 수명 요구 사항

NDK_FN_CREATE_MR

NDK_FN_FAST_REGISTER

NDK_FN_REQUEST_COMPLETION

NDK_MR