Função NmrRegisterProvider (netioddk.h)
A função NmrRegisterProvider registra um módulo de provedor com o NMR.
Sintaxe
NTSTATUS NmrRegisterProvider(
[in] PNPI_PROVIDER_CHARACTERISTICS ProviderCharacteristics,
[in] __drv_aliasesMem PVOID ProviderContext,
[out] PHANDLE NmrProviderHandle
);
Parâmetros
[in] ProviderCharacteristics
Um ponteiro para um NPI_PROVIDER_CHARACTERISTICS estrutura que descreve as características do módulo do provedor. O módulo do provedor deve garantir que essa estrutura permaneça válida e resida na memória, desde que o módulo do provedor seja registrado com o NMR.
[in] ProviderContext
Um ponteiro para um contexto fornecido pelo chamador para o registro. O módulo do provedor usa esse contexto para acompanhar o estado do registro do provedor. O conteúdo do contexto de registro do módulo do provedor é opaco para a NMR. O NMR passa esse ponteiro para o módulo do provedor sempre que chama a função de retorno de chamada ProviderAttachClient do módulo de provedor. O módulo do provedor deve garantir que esse contexto permaneça válido e resida na memória, desde que o módulo do provedor seja registrado com o NMR.
[out] NmrProviderHandle
Um ponteiro para uma variável que recebe um identificador usado pela NMR para representar o registro do módulo do provedor. O módulo do provedor deve salvar esse identificador e passá-lo como um parâmetro para a função NmrDeregisterProvider quando ele desregistro da NMR.
Valor de retorno
A função NmrRegisterProvider retorna um dos seguintes códigos NTSTATUS:
| Código de retorno | Descrição |
|---|---|
|
O NMR registrou com êxito o módulo do provedor. |
|
O NMR não tinha recursos suficientes do sistema para registrar o módulo do provedor. |
|
Ocorreu um erro. |
Observações
Um módulo de provedor chama a função NmrRegisterProvider para se registrar como um provedor de um de NPI para que ele possa anexar a módulos cliente que se registram como clientes da mesma NPI.
Um módulo de provedor normalmente chama a função NmrRegisterProvider de sua função DriverEntry depois de concluir todas as outras tarefas de inicialização. A chamada para a função NmrRegisterProvider indica à NMR que o módulo do provedor está pronto para anexar a todos os módulos cliente que se registraram ou se registrarão como clientes do mesmo de NPI para os quais o módulo do provedor se registrou como um provedor.
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 |