NmrRegisterProvider-Funktion (netioddk.h)
Die NmrRegisterProvider-Funktion registriert ein Anbietermodul beim NMR.
Syntax
NTSTATUS NmrRegisterProvider(
[in] PNPI_PROVIDER_CHARACTERISTICS ProviderCharacteristics,
[in] __drv_aliasesMem PVOID ProviderContext,
[out] PHANDLE NmrProviderHandle
);
Parameter
[in] ProviderCharacteristics
Ein Zeiger auf eine NPI_PROVIDER_CHARACTERISTICS Struktur, die die Merkmale des Anbietermoduls beschreibt. Das Anbietermodul muss sicherstellen, dass diese Struktur gültig bleibt und sich im Arbeitsspeicher befindet, solange das Anbietermodul beim NMR registriert ist.
[in] ProviderContext
Ein Zeiger auf einen vom Aufrufer bereitgestellten Kontext für die Registrierung. Das Anbietermodul verwendet diesen Kontext, um den Status der Anbieterregistrierung nachzuverfolgen. Der Inhalt des Registrierungskontexts des Anbietermoduls ist für den NMR undurchsichtig. Der NMR übergibt diesen Zeiger immer dann an das Anbietermodul, wenn es die ProviderAttachClient-Rückruffunktion des Anbietermoduls aufruft. Das Anbietermodul muss sicherstellen, dass dieser Kontext gültig bleibt und sich im Arbeitsspeicher befindet, solange das Anbietermodul beim NMR registriert ist.
[out] NmrProviderHandle
Ein Zeiger auf eine Variable, die ein Handle empfängt, das vom NMR zur Darstellung der Registrierung des Anbietermoduls verwendet wird. Das Anbietermodul muss dieses Handle speichern und es als Parameter an die NmrDeregisterProvider-Funktion übergeben, wenn die Registrierung beim NMR aufgehoben wird.
Rückgabewert
Die NmrRegisterProvider-Funktion gibt einen der folgenden NTSTATUS-Codes zurück:
| Rückgabecode | Beschreibung |
|---|---|
|
Der NMR hat das Anbietermodul erfolgreich registriert. |
|
Der NMR verfügte nicht über ausreichende Systemressourcen, um das Anbietermodul zu registrieren. |
|
Ein Fehler ist aufgetreten. |
Hinweise
Ein Anbietermodul ruft die NmrRegisterProvider-Funktion auf, um sich als Anbieter eines NPI zu registrieren, damit es Clientmodule anfügen kann, die sich als Clients desselben NPI registrieren.
Ein Anbietermodul ruft in der Regel die NmrRegisterProvider-Funktion aus seiner DriverEntry-Funktion auf, nachdem alle anderen Initialisierungsaufgaben abgeschlossen wurden. Der Aufruf der NmrRegisterProvider-Funktion gibt dem NMR an, dass das Anbietermodul bereit ist, Clientmodule anzufügen, die sich als Clients derselben NPI registriert haben oder registrieren, für die das Anbietermodul als Anbieter registriert ist.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
| Zielplattform | Desktop |
| Kopfzeile | netioddk.h (include Wsk.h) |
| Bibliothek | Netio.lib |
| IRQL | PASSIVE_LEVEL |