Funzione WskCaptureProviderNPI (wsk.h)
La funzione WskCaptureProviderNPI acquisisce un provider Network Programming Interface (NPI) quando diventa disponibile dal sottosistema WSK.
Sintassi
NTSTATUS WskCaptureProviderNPI(
[in] PWSK_REGISTRATION WskRegistration,
[in] ULONG WaitTimeout,
[out] PWSK_PROVIDER_NPI WskProviderNpi
);
Parametri
[in] WskRegistration
Puntatore alla posizione di memoria inizializzata da WskRegister che identifica un'istanza di registrazione dell'applicazione WSK. Per altre informazioni, vedere WSK_REGISTRATION.
[in] WaitTimeout
Il tempo, in millisecondi, che la funzione WskCaptureProviderNPI può attendere fino a quando non diventa disponibile il provider WSK. In alternativa, è possibile specificare quanto segue:
WSK_NO_WAIT
Restituisce da questa funzione immediatamente se il provider NPI non è disponibile.
WSK_INFINITE_WAIT
Attendere fino a quando il provider npI non è disponibile dal sottosistema WSK.
Per altre informazioni su come viene usato questo parametro, vedere Registrazione di un'applicazione kernel Winsock.
[out] WskProviderNpi
Puntatore al provider WSK restituito dal provider WSK. Questa struttura WSK_PROVIDER_NPI contiene un puntatore alla tabella di invio del provider WSK delle funzioni WSK che l'applicazione WSK può chiamare.
Valore restituito
WskCaptureProviderNPI restituisce uno dei codici NTSTATUS seguenti:
| Codice restituito | Descrizione |
|---|---|
|
L'acquisizione dei criteri di rete del provider è stata completata correttamente. |
|
Il provider NPI non è ancora disponibile. |
|
La versione richiesta dal client WSK non è supportata dal sottosistema WSK. |
|
L'acquisizione dei criteri di rete del provider non è riuscita. |
Commenti
Per ogni chiamata a WskCaptureProviderNPI che restituisce un codice riuscito, deve essere presente esattamente una chiamata WskReleaseProviderNPI corrispondente che usa lo stesso parametro WskRegistration passato a WskCaptureProviderNPI.
WskCaptureProviderNPI può essere chiamato dopo che viene effettuata una chiamata a WskDeregister solo se il blocco WskRegistration non è liberato o sovrascritto. Dopo aver chiamato WskDeregister , tutte le chiamate aggiuntive a WskCaptureProviderNPI avranno esito negativo con il codice di stato STATUS_DEVICE_NOT_READY e, a meno che il provider NPI non diventi disponibile simultaneamente, tutte le chiamate WskCaptureProviderNPI esistenti bloccate in altri thread in attesa che il provider WSK npI diventi disponibile restituirà immediatamente con il codice di stato STATUS_DEVICE_NOT_READY.
Per altre informazioni sul collegamento di un'applicazione WSK al sottosistema WSK, vedere Registrazione di un'applicazione kernel Winsock.
I chiamanti della funzione WskCaptureProviderNPI devono essere eseguiti in IRQL = PASSIVE_LEVEL se WaitTimeout non è impostato su WSK_NO_WAIT; in caso contrario, i chiamanti devono essere in esecuzione in IRQL <= DISPATCH_LEVEL.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows. |
| Piattaforma di destinazione | Universale |
| Intestazione | wsk.h (include Wsk.h) |
| Libreria | Netio.lib |
| IRQL | PASSIVE_LEVEL (vedere la sezione Osservazioni) |