NDK_FN_MODIFY_SRQ fonction de rappel (ndkpi.h)
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 NDK (SRQ).
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 mises 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 se déclencher lorsque le nombre de demandes de réception mises en file d’attente tombe sous 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 non nulle. Si une valeur de seuil de zéro est spécifiée, le fournisseur doit conserver le seuil de notification SRQ actuel et l’état 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 à transmettre au paramètre Context de la fonction de rappel spécifiée dans le paramètre RequestCompletion.
Valeur de retour
La fonction NdkModifySrq retourne l’un des codes NTSTATUS suivants.
| Retourner le code | Description |
|---|---|
|
La demande a été effectuée avec succès. |
|
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. |
|
La requête a échoué, car la valeur du paramètre SrqDepth n’est pas comprise dans les limites spécifiées dans la structure NDK_ADAPTER_INFO. |
|
Une erreur s’est produite. |
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).
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Aucune prise en charge, prise en charge dans NDIS 6.30 et versions ultérieures. |
| serveur minimum pris en charge | Windows Server 2012 |
| plateforme cible | Windows |
| d’en-tête | ndkpi.h (include Ndkpi.h) |
| IRQL | <=DISPATCH_LEVEL |