Funzione NmrRegisterClient (netioddk.h)
La funzione NmrRegisterClient registra un modulo client con NMR.
Sintassi
NTSTATUS NmrRegisterClient(
[in] PNPI_CLIENT_CHARACTERISTICS ClientCharacteristics,
[in] __drv_aliasesMem PVOID ClientContext,
[out] PHANDLE NmrClientHandle
);
Parametri
[in] ClientCharacteristics
Puntatore a un oggetto NPI_CLIENT_CHARACTERISTICS struttura che descrive le caratteristiche del modulo client. Il modulo client deve assicurarsi che questa struttura rimanga valida e residente in memoria, purché il modulo client sia registrato con nmR.
[in] ClientContext
Puntatore a un contesto fornito dal chiamante per la registrazione. Il modulo client usa questo contesto per tenere traccia dello stato della registrazione client. Il contenuto del contesto di registrazione del modulo client è opaco al nmR. NmR passa questo puntatore al modulo client ogni volta che chiama la funzione di callback clientAttachProvider del modulo client. Il modulo client deve assicurarsi che il contesto di registrazione rimanga valido e residente in memoria, purché il modulo client sia registrato con nmR.
[out] NmrClientHandle
Puntatore a una variabile che riceve un handle usato dal nmR per rappresentare la registrazione del modulo client. Il modulo client deve salvare questo handle e passarlo come parametro alla funzione NmrDeregisterClient quando deregisters da NMR.
Valore restituito
La funzione NmrRegisterClient restituisce uno dei codici NTSTATUS seguenti:
| Codice restituito | Descrizione |
|---|---|
|
NmR ha registrato correttamente il modulo client. |
|
NmR non disponeva di risorse di sistema sufficienti per registrare il modulo client. |
|
Si è verificato un errore. |
Commenti
Un modulo client chiama la funzione NmrRegisterClient per registrare come client di un'entità criteri di rete in modo che possa connettersi ai moduli del provider che registrano come provider dello stesso npI .
Un modulo client chiama in genere la funzione NmrRegisterClient dalla funzione DriverEntry dopo aver completato tutte le altre attività di inizializzazione. La chiamata alla funzione NmrRegisterClient indica al nmR che il modulo client è pronto per connettersi a tutti i moduli del provider registrati o registreranno come provider della stessa funzione NPI per cui il modulo client è registrato come client.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows. |
| Piattaforma di destinazione | Desktop |
| Intestazione | netioddk.h (include Wsk.h) |
| Libreria | Netio.lib |
| IRQL | PASSIVE_LEVEL |