NdisMDeregisterDevice

NDIS_STATUS NdisMDeregisterDevice( IN NDIS_HANDLE NdisDeviceHandle );

NdisMDeregisterDevice 함수는 NdisMRegisterDevice 함수를 가지고 생성한 장치 객체를 시스템에서 제거한다. NdisMDeregisterDevice 함수는 또한 이 장치 객체와 연관된 심볼릭 링크를 제거한다.

매개변수

NdisDeviceHandle

자이 객체가 등록해제된 것을 확인시키는, NdisMRegisterDevice 함수에 의해서 리턴된 핸들을 서술한다.

리턴값

장치 객체와 그것에 연관된 심볼릭 링크 객체가 삭제됐다면 NdisMDeregisterDevice 함수는 NDIS_STATUS_SUCCESS를 리턴한다.

주석

전에 NdisMRegisterDevice 함수로 생성한 유일한 장치 객체의 등록해제를 위해서 드라이버는 Halt 혹은 Unload 함수에서 NdisMDeregisterDevice 함수를 호출한다. 드라이버가 언로드되거나 DriverEntry 루틴이 시스템자원 얻기 실패같은 치명적인 초기화 에러를 만났을 때 드라이버는 NdisMDeregisterDevice 함수를 호출해야만한다.

NdisMRegisterDevice 함수가 호출됐을 때 삭제되는 장치 객체에서 특정 사용자 모드 열기 연산을 할 수 없다. 할 수 있다면 시스템 에러가 발생한다.

NdisMDeregisterDevice 함수의 호출자는 IRQL PASSIVE_LEVEL에서 실행한다.