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 residente 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 o 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 residente 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.

Retornar valor

A função NmrRegisterClient retorna um dos seguintes códigos NTSTATUS:

Código de retorno	Descrição
STATUS_SUCCESS	O NMR registrou com êxito o módulo cliente.
STATUS_INSUFFICIENT_RESOURCES	A NMR não tinha recursos suficientes do sistema para registrar o módulo cliente.
Outros códigos status	Ocorreu um erro.

Comentários

Um módulo cliente chama a função NmrRegisterClient para se registrar como um cliente de uma NPI para que ela possa ser anexada aos módulos do 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 que se registraram ou se registrarão como provedores da mesma NPI para a qual o módulo cliente se registrou como um cliente.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.
Plataforma de Destino	Área de Trabalho
Cabeçalho	netioddk.h (inclua Wsk.h)
Biblioteca	Netio.lib
IRQL	PASSIVE_LEVEL

Confira também

DriverEntry

NPI_CLIENT_CHARACTERISTICS

NmrDeregisterClient