NDK_FN_MODIFY_SRQ fonction de rappel (ndkpi.h)

Article
02/29/2024

La fonction NdkModifySrq (NDK_FN_MODIFY_SRQ) modifie la taille et le seuil de notification d’une file d’attente de réception partagée (SRQ) NDK.

Syntaxe

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

Paramètres

[in] pNdkSrq

Pointeur vers un objet de file d’attente de réception partagée (SRQ) NDK (NDK_SRQ).

[in] SrqDepth

Nouvelle taille de la SRQ. La nouvelle taille doit être inférieure ou égale à la taille spécifiée dans le membre MaxSrqDepth de la structure NDK_ADAPTER_INFO . Une taille de zéro signifie qu’aucune modification de profondeur n’est demandée. Autrement dit, la valeur de profondeur SRQ existante doit être conservée.

[in] NotifyThreshold

Nombre de demandes de réception en file d’attente qui déclenchent un rappel de notification SRQ. Si cette valeur est supérieure à zéro, le fournisseur NDK doit armer la notification SRQ pour qu’elle se déclenche lorsque le nombre de demandes de réception en file d’attente est inférieur à la valeur spécifiée. Si le nombre de demandes de réception en file d’attente est déjà inférieur à la valeur seuil au moment de cet appel de fonction, une notification SRQ doit être générée. Une fois qu’une notification SRQ est générée, d’autres notifications sont désarmées jusqu’à ce que le consommateur NDK appelle à nouveau cette fonction avec une valeur de seuil autre que zéro. Si une valeur de seuil égale à zéro est spécifiée, le fournisseur doit conserver le seuil de notification SRQ actuel et les status d’armage.

[in] RequestCompletion

Pointeur vers une routine de rappel de fin de requête NdkRequestCompletion (NDK_FN_REQUEST_COMPLETION).

[in, optional] RequestContext

Valeur de contexte à passer au paramètre Context de la fonction de rappel spécifiée dans le paramètre RequestCompletion .

Valeur retournée

La fonction NdkModifySrq retourne l’un des codes NTSTATUS suivants.

Code de retour	Description
STATUS_SUCCESS	La demande a été effectuée avec succès.
STATUS_PENDING	L’opération est en attente et sera terminée ultérieurement. Le pilote appelle la fonction RequestCompletion (NDK_FN_REQUEST_COMPLETION) spécifiée pour terminer l’opération en attente.
STATUS_INVALID_PARAMETER	La demande a échoué, car la valeur dans le paramètre SrqDepth n’est pas dans les limites spécifiées dans la structure NDK_ADAPTER_INFO .
Autres codes status	Une erreur est survenue.

Remarques

NdkModifySrq modifie la taille et le seuil de notification d’un objet de file d’attente de réception partagée (SRQ) NDK (NDK_SRQ).

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Aucune prise en charge, prise en charge dans NDIS 6.30 et versions ultérieures.
Serveur minimal pris en charge	Windows Server 2012
Plateforme cible	Windows
En-tête	ndkpi.h (incluez Ndkpi.h)
IRQL	<=DISPATCH_LEVEL

Voir aussi

Exigences relatives à la durée de vie des objets NDKPI

NDK_ADAPTER_INFO

NDK_FN_REQUEST_COMPLETION

NDK_SRQ

Partager via