Função RxUnregisterMinirdr (rxstruc.h)

Artigo
02/26/2024

RxUnregisterMinirdr é uma rotina embutida chamada por um driver de minidiretório de rede para desregistrar o driver com RDBSS e remover as informações de registro da tabela interna de registro rdbss.

Sintaxe

void RxUnregisterMinirdr(
  [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

RxUnregisterMinirdr é uma rotina embutida definida em rxstruc.h que desregistra o driver com RDBSS e remove as informações de registro da tabela interna de registro RDBSS. Se as tabelas de nomes foram inicializadas, essas tabelas serão finalizadas para versão. 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. RxUnregisterMinirdr também tenta remover o objeto de dispositivo do sistema chamando IoDeleteDevice.

Normalmente, a rotina RxUnregisterMinirdr é 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 preferencial 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.