共用方式為

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 成員中指定的大小。 零的大小表示不會要求任何深度修改。 也就是說，必須保留現有的SRQ深度值。

[in] NotifyThreshold

將觸發 SRQ 通知回呼的佇列接收要求數目。 如果此值大於零，當佇列接收要求數目低於指定的值時，NDK 提供者必須發出 SRQ 通知以觸發。 如果佇列接收要求的數目已經低於此函數調用時的臨界值，則必須產生 SRQ 通知。 產生 SRQ 通知之後，會解除進一步通知，直到 NDK 取用者再次以非零閾值叫用此函式為止。 如果指定了零的臨界值，提供者必須保留目前的 SRQ 通知閾值和 arming 狀態。

[in] RequestCompletion

要求完成回呼例程 NdkRequestCompletion 的指標， (NDK_FN_REQUEST_COMPLETION) 。

[in, optional] RequestContext

要傳遞至 RequestCompletion 參數中所指定回呼函式之 Context 參數的內容值。

傳回值

NdkModifySrq 函式會傳回下列其中一個 NTSTATUS 程式代碼。

傳回碼 Description
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