WskCaptureProviderNPI-Funktion (wsk.h)
Die WskCaptureProviderNPI--Funktion erfasst einen Anbieter Netzwerkprogrammierschnittstelle (Network Programming Interface, NPI), wenn er über das WSK-Subsystem verfügbar wird.
Syntax
NTSTATUS WskCaptureProviderNPI(
[in] PWSK_REGISTRATION WskRegistration,
[in] ULONG WaitTimeout,
[out] PWSK_PROVIDER_NPI WskProviderNpi
);
Parameter
[in] WskRegistration
Ein Zeiger auf den Von WskRegister initialisierten Speicherspeicherort, der die Registrierungsinstanz einer WSK-Anwendung identifiziert. Weitere Informationen finden Sie unter WSK_REGISTRATION.
[in] WaitTimeout
Die Zeit in Millisekunden, zu der die WskCaptureProviderNPI--Funktion warten kann, bis der NPI des WSK-Anbieters verfügbar ist. Alternativ kann Folgendes angegeben werden:
WSK_NO_WAIT
Wird sofort von dieser Funktion zurückgegeben, wenn der Anbieter-NPI nicht verfügbar ist.
WSK_INFINITE_WAIT
Warten Sie, bis der Anbieter-NPI über das WSK-Subsystem verfügbar ist.
Weitere Informationen zur Verwendung dieses Parameters finden Sie unter Registrieren einer Winsock Kernel-Anwendung.
[out] WskProviderNpi
Ein Zeiger auf den vom WSK-Anbieter zurückgegebenen NPI. Diese WSK_PROVIDER_NPI-Struktur enthält einen Zeiger auf die WSK-Anbieter-Verteilertabelle von WSK-Funktionen, die die WSK-Anwendung aufrufen kann.
Rückgabewert
WskCaptureProviderNPI gibt einen der folgenden NTSTATUS-Codes zurück:
| Rückgabecode | Beschreibung |
|---|---|
|
Die NPI-Erfassung des Anbieters wurde erfolgreich abgeschlossen. |
|
Der Anbieter-NPI war noch nicht verfügbar. |
|
Die vom WSK-Client angeforderte Version wird vom WSK-Subsystem nicht unterstützt. |
|
Fehler bei der Anbieter-NPI-Erfassung. |
Bemerkungen
Für jeden Aufruf von WskCaptureProviderNPI, der einen Erfolgscode zurückgibt, muss es genau einen entsprechenden WskReleaseProviderNPI--Aufruf geben, der denselben WskRegistration Parameter verwendet, der an WskCaptureProviderNPIübergeben wurde.
WskCaptureProviderNPI- kann aufgerufen werden, nachdem ein Aufruf an WskDeregister erfolgt, wenn der WskRegistration--Block nicht freigegeben oder überschrieben wird. Nachdem WskDeregister- aufgerufen wurde, treten alle weiteren Aufrufe von WskCaptureProviderNPI- mit Statuscode STATUS_DEVICE_NOT_READY fehl, und es sei denn, der Anbieter-NPI wird gleichzeitig verfügbar, alle vorhandenen WskCaptureProviderNPI Aufrufe, die in anderen Threads blockiert werden, die auf den verfügbaren WSK-Anbieter NPI warten, werden ebenfalls sofort mit Statuscode STATUS_DEVICE_NOT_READY zurückgegeben.
Weitere Informationen zum Anfügen einer WSK-Anwendung an das WSK-Subsystem finden Sie unter Registrieren einer Winsock Kernel-Anwendung.
Aufrufer der WskCaptureProviderNPI--Funktion müssen bei IRQL = PASSIVE_LEVEL ausgeführt werden, wenn WaitTimeout- nicht auf WSK_NO_WAIT festgelegt ist; andernfalls müssen Aufrufer unter IRQL-<= DISPATCH_LEVEL ausgeführt werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
| Zielplattform- | Universal |
| Header- | wsk.h (include Wsk.h) |
| Library | Netio.lib |
| IRQL- | PASSIVE_LEVEL (siehe Abschnitt "Hinweise") |