WskCaptureProviderNPI, fonction (wsk.h)
La fonction WskCaptureProviderNPI capture un fournisseur L’interface de programmation réseau (NPI) lorsqu’elle devient disponible à partir du sous-système WSK.
Syntaxe
NTSTATUS WskCaptureProviderNPI(
[in] PWSK_REGISTRATION WskRegistration,
[in] ULONG WaitTimeout,
[out] PWSK_PROVIDER_NPI WskProviderNpi
);
Paramètres
[in] WskRegistration
Pointeur vers l’emplacement de mémoire initialisé par WskRegister qui identifie l’instance d’inscription d’une application WSK. Pour plus d’informations, consultez WSK_REGISTRATION.
[in] WaitTimeout
Temps, en millisecondes, pendant lequel la fonction WskCaptureProviderNPI peut attendre que l’indicateur NPI du fournisseur WSK soit disponible. Vous pouvez également spécifier ce qui suit :
WSK_NO_WAIT
Revenez immédiatement de cette fonction si l’indicateur de performance réseau du fournisseur n’est pas disponible.
WSK_INFINITE_WAIT
Attendez que l’indicateur de performance réseau du fournisseur soit disponible à partir du sous-système WSK.
Pour plus d’informations sur l’utilisation de ce paramètre, consultez Inscrire une application de noyau Winsock.
[out] WskProviderNpi
Pointeur vers l’indicateur NPI retourné par le fournisseur WSK. Cette structure WSK_PROVIDER_NPI contient un pointeur vers la table de distribution du fournisseur WSK des fonctions WSK que l’application WSK peut appeler.
Valeur de retour
WskCaptureProviderNPI retourne l’un des codes NTSTATUS suivants :
| Retourner le code | Description |
|---|---|
|
La capture NPI du fournisseur s’est terminée avec succès. |
|
L’indicateur NPI du fournisseur n’a pas encore été disponible. |
|
La version demandée par le client WSK n’est pas prise en charge par le sous-système WSK. |
|
Échec de la capture NPI du fournisseur. |
Remarques
Pour chaque appel à WskCaptureProviderNPI qui retourne un code de réussite, il doit y avoir exactement un WskReleaseProviderNPI qui utilise le même paramètre WskRegistration qui a été passé à WskCaptureProviderNPI.
WskCaptureProviderNPI peut être appelé une fois qu’un appel est effectué pour WskDeregister uniquement si le bloc WskRegistration n’est pas libéré ou remplacé. Après WskDeregister est appelé, les autres appels à WskCaptureProviderNPI échouent avec le code d’état STATUS_DEVICE_NOT_READY et, à moins que l’indicateur de sécurité réseau du fournisseur ne soit disponible simultanément, tous les appels existants WskCaptureProviderNPI qui sont bloqués dans d’autres threads en attendant que l’indicateur NPI du fournisseur WSK soit disponible retourne également immédiatement avec le code d’état STATUS_DEVICE_NOT_READY.
Pour plus d’informations sur l’attachement d’une application WSK au sous-système WSK, consultez Inscription d’une application de noyau Winsock.
Les appelants de la fonction WskCaptureProviderNPI doivent s’exécuter à IRQL = PASSIVE_LEVEL si waitTimeout n’est pas défini sur WSK_NO_WAIT ; sinon, les appelants doivent s’exécuter à l'<IRQL = DISPATCH_LEVEL.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows. |
| plateforme cible | Universel |
| d’en-tête | wsk.h (include Wsk.h) |
| bibliothèque | Netio.lib |
| IRQL | PASSIVE_LEVEL (voir la section Remarques) |