NDK_FN_INVALIDATE 콜백 함수(ndkpi.h)

아티클
02/05/2022
읽는 데 3분 걸림

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

NDK QP(큐 쌍) 개체(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) 이상에서만 지원됩니다.

반환 값

이
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