Função RxpUnregisterMinirdr (mrx.h)

Artigo
02/26/2024

RxpUnregisterMinirdr é chamado por um driver de minidiretório de rede para desregistrar o driver com RDBSS e remover as informações de registro da tabela de registro rdbss interna.

Sintaxe

void RxpUnregisterMinirdr(
  [in] IN PRDBSS_DEVICE_OBJECT RxDeviceObject
);

Parâmetros

[in] RxDeviceObject

Um ponteiro para o objeto de dispositivo RDBSS para esse redirecionador de rede.

Retornar valor

Nenhum

Comentários

A rotina RxpUnregisterMinirdr cancela o registro do driver com RDBSS e remove as informações de registro da tabela de registro rdbss interna. Se as tabelas de nomes forem inicializadas, essas tabelas serão finalizadas para lançamento. Todas as solicitações assíncronas pendentes para o minidiretório de rede são giradas para baixo e todos os threads de trabalho associados ao redirecionador são girados para baixo. RxpUnregisterMinirdr também tenta remover o objeto do dispositivo do sistema chamando IoDeleteDevice.

A rotina RxpUnregisterMinirdr geralmente é chamada como resultado de uma solicitação FSCTL ou IOCTL de um aplicativo ou serviço de modo de usuário para descarregar o minidiretório de rede, embora essa chamada também possa ser feita do minidiretório de rede ou como parte do processamento de desligamento pelo sistema operacional ou como resultado de uma falha na rotina driverEntry .

Observe que a rotina embutida, RxUnregisterMinirdr, é a maneira preferida de cancelar o registro de um driver com RDBSS. A rotina embutida RxUnregisterMinirdr chama RxpUnregisterMinirdr, mas também diminui a referência de objeto ao objeto de dispositivo RDBSS para que esse objeto possa ser liberado pelo sistema.