Função NmrRegisterClient (netioddk.h)
A função NmrRegisterClient registra um módulo cliente com o NMR.
Sintaxe
NTSTATUS NmrRegisterClient(
[in] PNPI_CLIENT_CHARACTERISTICS ClientCharacteristics,
[in] __drv_aliasesMem PVOID ClientContext,
[out] PHANDLE NmrClientHandle
);
Parâmetros
[in] ClientCharacteristics
Um ponteiro para um NPI_CLIENT_CHARACTERISTICS estrutura que descreve as características do módulo cliente. O módulo cliente deve garantir que essa estrutura permaneça válida e resida na memória, desde que o módulo cliente seja registrado com o NMR.
[in] ClientContext
Um ponteiro para um contexto fornecido pelo chamador para o registro. O módulo cliente usa esse contexto para acompanhar o estado do registro do cliente. O conteúdo do contexto de registro do módulo cliente é opaco para a NMR. O NMR passa esse ponteiro para o módulo cliente sempre que chama a função de retorno de chamada ClientAttachProvider do módulo cliente. O módulo cliente deve garantir que seu contexto de registro permaneça válido e resida na memória, desde que o módulo cliente seja registrado com o NMR.
[out] NmrClientHandle
Um ponteiro para uma variável que recebe um identificador usado pela NMR para representar o registro do módulo cliente. O módulo cliente deve salvar esse identificador e passá-lo como um parâmetro para a função NmrDeregisterClient quando ele desregistros do NMR.
Valor de retorno
A função NmrRegisterClient retorna um dos seguintes códigos NTSTATUS:
| Código de retorno | Descrição |
|---|---|
|
O NMR registrou com êxito o módulo do cliente. |
|
O NMR não tinha recursos suficientes do sistema para registrar o módulo cliente. |
|
Ocorreu um erro. |
Observações
Um módulo cliente chama a função NmrRegisterClient para se registrar como um cliente de um de NPI para que ele possa anexar a módulos de provedor que se registram como provedores da mesma NPI.
Um módulo cliente normalmente chama a função NmrRegisterClient de sua função DriverEntry depois de concluir todas as outras tarefas de inicialização. A chamada para a função NmrRegisterClient indica à NMR que o módulo cliente está pronto para anexar a todos os módulos de provedor registrados ou que serão registrados como provedores do mesmo de NPI para os quais o módulo cliente se registrou como cliente.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows. |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | netioddk.h (inclua Wsk.h) |
| biblioteca | Netio.lib |
| IRQL | PASSIVE_LEVEL |