NDK_FN_INVALIDATE 콜백 함수(ndkpi.h)

아티클
08/07/2023

NdkInvalidate(NDK_FN_INVALIDATE) 함수는 MR(빠른 등록 NDK 메모리 영역) 또는 MW(메모리 창)를 무효화합니다.

구문

NDK_FN_INVALIDATE NdkFnInvalidate;

NTSTATUS NdkFnInvalidate(
  [in]           NDK_QP *pNdkQp,
  [in, optional] PVOID RequestContext,
  [in]           NDK_OBJECT_HEADER *pNdkMrOrMw,
  [in]           ULONG Flags
)
{...}

매개 변수

[in] pNdkQp

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

[in, optional] RequestContext

이 요청에 대한 NDK_RESULT 구조체의 RequestContext 멤버에서 반환할 컨텍스트 값입니다.

[in] pNdkMrOrMw

NDK_OBJECT_HEADER 구조에 지정된 MR(메모리 영역) 개체(NDK_MR) 또는 메모리(MW) 개체( NDK_MW )에 대한 포인터입니다. MR 개체를 지정한 경우 MR 개체가 NdkFastRegister (NDK_FN_FAST_REGISTER) 함수에 등록되어 있어야 합니다. NDK 소비자는 pNdkMrOrMw 매개 변수에서 NdkRegister(NDK_FN_REGISTER) 함수에 등록된 MR 개체를 지정해서는 안 됩니다. NdkRegister(NDK_FN_REGISTER) 함수에 등록된 MR 개체에 대한 액세스는 NdkDeregisterMr(NDK_FN_DEREGISTER_MR) 함수를 사용하여 제거할 수 있습니다.

[in] Flags

허용되는 작업을 지정하는 플래그의 비트 OR입니다. 지원되는 플래그는 다음과 같습니다.

값	의미
NDK_OP_FLAG_SILENT_SUCCESS 0x00000001	이 요청을 성공적으로 완료해도 아웃바운드 완료 큐에서 완료 이벤트가 생성되지 않음을 나타냅니다. 그러나 실패한 요청은 완료 큐에서 이벤트를 생성합니다.
NDK_OP_FLAG_READ_FENCE 0x00000002	하드웨어가 이 요청 처리를 시작하기 전에 모든 이전 읽기 요청을 완료해야 했음을 나타냅니다.
NDK_OP_FLAG_DEFER 0x00000200	처리를 위해 하드웨어에 대한 요청을 나타내는 것을 연기할 수 있음을 NDK 공급자에게 나타냅니다. 이 플래그에 대한 자세한 내용은 NDKPI 지연 처리 체계를 참조하세요. 참고 이 플래그는 NDKPI 1.2(Windows Server 2012 R2) 이상에서만 지원됩니다.

반환 값

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

반환 코드	설명
STATUS_SUCCESS	요청이 성공적으로 게시되었습니다. 작업 요청이 완료되면 완료 항목이 CQ에 큐에 대기됩니다.
STATUS_CONNECTION_INVALID	QP가 연결되지 않았습니다.
기타 상태 코드	오류가 발생했습니다.

설명

NdkInvalidate 는 NDK 빠른 등록 MR 또는 MW를 무효화합니다.

요구 사항

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