NDK_FN_MODIFY_SRQ 콜백 함수(ndkpi.h)

  • 아티클

NdkModifySrq(NDK_FN_MODIFY_SRQ) 함수는 NDK SRQ(공유 수신 큐)의 크기 및 알림 임계값을 수정합니다.

구문

NDK_FN_MODIFY_SRQ NdkFnModifySrq;

NTSTATUS NdkFnModifySrq(
  [in]           NDK_SRQ *pNdkSrq,
  [in]           ULONG SrqDepth,
  [in]           ULONG NotifyThreshold,
  [in]           NDK_FN_REQUEST_COMPLETION RequestCompletion,
  [in, optional] PVOID RequestContext
)
{...}

매개 변수

[in] pNdkSrq

NDK SRQ(공유 수신 큐) 개체(NDK_SRQ)에 대한 포인터입니다.

[in] SrqDepth

SRQ의 새 크기입니다. 새 크기는 NDK_ADAPTER_INFO 구조체의 MaxSrqDepth 멤버에 지정된 크기보다 작거나 같아야 합니다. 크기가 0이면 깊이 수정이 요청되지 않습니다. 즉, 기존 SRQ 깊이 값을 유지해야 합니다.

[in] NotifyThreshold

SRQ 알림 콜백을 트리거할 큐에 대기 중인 수신 요청 수입니다. 이 값이 0보다 큰 경우 NDK 공급자는 대기 중인 수신 요청 수가 지정된 값보다 낮을 때 트리거하도록 SRQ 알림을 arm으로 설정해야 합니다. 대기 중인 수신 요청 수가 이 함수 호출 시 임계값보다 이미 낮으면 SRQ 알림이 생성되어야 합니다. SRQ 알림이 생성되면 NDK 소비자가 0이 아닌 임계값으로 이 함수를 다시 호출할 때까지 추가 알림이 해제됩니다. 임계값이 0으로 지정된 경우 공급자는 현재 SRQ 알림 임계값 및 무장 상태 유지해야 합니다.

[in] RequestCompletion

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

[in, optional] RequestContext

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

반환 값

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

반환 코드 설명
STATUS_SUCCESS
 요청이 성공적으로 완료되었습니다.
STATUS_PENDING
 작업이 보류 중이며 나중에 완료됩니다. 드라이버는 지정된 RequestCompletion (NDK_FN_REQUEST_COMPLETION) 함수를 호출하여 보류 중인 작업을 완료합니다.
STATUS_INVALID_PARAMETER
 SrqDepth 매개 변수의 값이 NDK_ADAPTER_INFO 구조에 지정된 한도 내에 있지 않기 때문에 요청이 실패했습니다.
기타 상태 코드
 오류가 발생했습니다.

설명

NdkModifySrq 는 NDK SRQ(공유 수신 큐) 개체(NDK_SRQ)에 대한 크기 및 알림 임계값을 수정합니다.

요구 사항

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

추가 정보

NDKPI 개체 수명 요구 사항

NDK_ADAPTER_INFO

NDK_FN_REQUEST_COMPLETION

NDK_SRQ