NDK_FN_MODIFY_SRQ funzione di callback (ndkpi.h)

Articolo
08/07/2023

La funzione NdkModifySrq (NDK_FN_MODIFY_SRQ) modifica le dimensioni e la soglia di notifica di una coda di ricezione condivisa NDK (SRQ).

Sintassi

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
)
{...}

Parametri

[in] pNdkSrq

Puntatore a un oggetto SRQ (NDK Shared Receive Queue) (NDK_SRQ).

[in] SrqDepth

Nuova dimensione del server di dominio srq. La nuova dimensione deve essere minore o uguale alla dimensione specificata nel membro MaxSrqDepth della struttura NDK_ADAPTER_INFO . Una dimensione pari a zero significa che non viene richiesta alcuna modifica della profondità. Vale a dire, il valore di profondità SRQ esistente deve essere mantenuto.

[in] NotifyThreshold

Numero di richieste di ricezione in coda che attiveranno un callback di notifica SRQ. Se questo valore è maggiore di zero, il provider NDK deve armeare la notifica SRQ per attivare quando il numero di richieste di ricezione accodate scende al di sotto del valore specificato. Se il numero di richieste di ricezione in coda è già inferiore al valore soglia al momento della chiamata alla funzione, deve essere generata una notifica SRQ. Dopo aver generato una notifica SRQ, le notifiche aggiuntive vengono disattivate finché il consumer NDK richiama nuovamente questa funzione con un valore soglia diverso da zero. Se viene specificato un valore soglia pari a zero, il provider deve mantenere la soglia di notifica SRQ corrente e lo stato di arming.

[in] RequestCompletion

Puntatore a una routine di callback del completamento della richiesta NdkRequestCompletion (NDK_FN_REQUEST_COMPLETION).

[in, optional] RequestContext

Valore di contesto da passare al parametro Context della funzione callback specificata nel parametro RequestCompletion .

Valore restituito

La funzione NdkModifySrq restituisce uno dei codici NTSTATUS seguenti.

Codice restituito	Descrizione
STATUS_SUCCESS	La richiesta è stata completata correttamente.
STATUS_PENDING	L'operazione è in sospeso e verrà completata in un secondo momento. Il driver chiamerà la funzione RequestCompletion (NDK_FN_REQUEST_COMPLETION) specificata per completare l'operazione in sospeso.
STATUS_INVALID_PARAMETER	La richiesta non è riuscita perché il valore nel parametro SrqDepth non rientra nei limiti specificati nella struttura NDK_ADAPTER_INFO .
Altri codici di stato	Si è verificato un errore.

Commenti

NdkModifySrq modifica le dimensioni e la soglia di notifica per un oggetto srQ (NDK Shared Receive Queue) (NDK_SRQ).

Requisiti

Requisito	Valore
Client minimo supportato	Nessuna supportata, supportata in NDIS 6.30 e versioni successive.
Server minimo supportato	Windows Server 2012
Piattaforma di destinazione	Windows
Intestazione	ndkpi.h (include Ndkpi.h)
IRQL	<=DISPATCH_LEVEL

Vedi anche

Requisiti di durata dell'oggetto ND KPI

NDK_ADAPTER_INFO

NDK_FN_REQUEST_COMPLETION

NDK_SRQ

Condividi tramite