Share via

Função NdisMDeregisterDevice (ndis.h)

  • Artigo

Nota NDIS 5. x foi preterido e substituído pelo NDIS 6. x. Para obter um novo desenvolvimento de driver NDIS, consulte Drivers de rede começando com o Windows Vista. Para obter informações sobre como portar o NDIS 5. x drivers para NDIS 6. x, consulte Portabilidade de drivers NDIS 5.x para NDIS 6.0.

A função NdisMDeregisterDevice remove do sistema um objeto de dispositivo que foi criado com NdisMRegisterDevice. NdisMDeregisterDevice também remove o link simbólico associado a esse objeto de dispositivo.

Sintaxe

NDIS_STATUS NdisMDeregisterDevice(
  [in] NDIS_HANDLE NdisDeviceHandle
);

Parâmetros

[in] NdisDeviceHandle

Especifica o identificador retornado por NdisMRegisterDevice que identifica o objeto de dispositivo a ser desregistrado.

Retornar valor

NdisMDeregisterDevice retornará NDIS_STATUS_SUCCESS se o objeto do dispositivo e seu objeto de link simbólico associado forem excluídos.

Comentários

Um driver chama NdisMDeregisterDevice de sua função Halt ou Unload para desregistrar um objeto de dispositivo autônomo que ele criou anteriormente com NdisMRegisterDevice. O driver deve chamar NdisMDeregisterDevice quando ele está sendo descarregado ou quando sua rotina DriverEntry encontra um erro de inicialização fatal, como uma incapacidade de obter recursos do sistema.

Quando NdisMRegisterDevice é chamado, não pode haver nenhuma operação aberta de modo de usuário pendente no objeto de dispositivo que está sendo excluído. Se houver, ocorrerá um erro do sistema.

  • Plataforma de destino: Universal
  • Versão: não há suporte para drivers NDIS 6.0 no Windows Vista. Com suporte para drivers NDIS 5.1 no Windows Vista e no Windows XP.

Requisitos

Requisito Valor
Cabeçalho ndis.h (inclua Ndis.h)
Biblioteca Ndis.lib
IRQL PASSIVE_LEVEL

Confira também