共用方式為

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 通知閾值和武裝狀態。

[in] RequestCompletion

要求完成回呼例程的指標 NdkRequestCompletion （NDK_FN_REQUEST_COMPLETION）。

[in, optional] RequestContext

要傳遞至回呼函式 Context 參數的內容值，該參數是在 RequestCompletion 參數中指定。

傳回值

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
目標平臺 窗戶
標頭 ndkpi.h （包括 Ndkpi.h）
IRQL <=DISPATCH_LEVEL

另請參閱

NDKPI 物件存留期需求

NDK_ADAPTER_INFO

NDK_FN_REQUEST_COMPLETION

NDK_SRQ