피드백

NmrDeregisterProvider 함수(netioddk.h)

  • 아티클
  • 읽는 데 3분 걸림

NmrDeregisterProvider 함수는 NMR에서 공급자 모듈의 등록을 취소합니다.

구문

NTSTATUS NmrDeregisterProvider(
  [in] HANDLE NmrProviderHandle
);

매개 변수

[in] NmrProviderHandle

NMR에서 공급자 모듈의 등록을 나타내는 데 사용하는 핸들입니다. 공급자 모듈이 NmrRegisterProvider 함수를 호출할 때 NMR은 이 핸들을 공급자 모듈에 반환합니다.

반환 값

NmrDeregisterProvider 함수는 다음 NTSTATUS 코드 중 하나를 반환합니다.

반환 코드 설명
STATUS_PENDING
 NMR은 공급자 모듈의 등록 취소를 시작했습니다. 공급자 모듈은 공급자 모듈을 언로드하기 전에 등록 취소가 완료될 때까지 대기하도록 NmrWaitForProviderDeregisterComplete 함수를 호출해야 합니다.
기타 상태 코드
 오류가 발생했습니다.

설명

공급자 모듈이 NmrDeregisterProvider 함수를 호출하면 NMR은 공급자 모듈의 ProviderDetachClient 콜백 함수와 공급자 모듈과 클라이언트 모듈 간의 각 바인딩에 대해 클라이언트 모듈의 ClientDetachProvider 콜백 함수를 호출합니다. 공급자 모듈이 연결된 모든 클라이언트 모듈에서 공급자 모듈을 성공적으로 분리하고 해당 클라이언트 모듈을 모두 공급자 모듈에서 분리한 후 NMR에서 공급자 모듈의 등록 취소가 완료됩니다.

공급자 모듈은 일반적으로 Unload 함수에서 NmrDeregisterProvider 함수를 호출하여 공급자 모듈이 시스템에서 언로드되기 전에 연결된 모든 클라이언트 모듈에서 자신을 분리합니다. NmrDeregisterProvider 함수를 호출한 후 공급자 모듈은 NmrWaitForProviderDeregisterComplete 함수를 호출하여 공급자 모듈을 언로드하기 전에 등록 취소가 완료될 때까지 기다려야 합니다. 공급자 모듈은 등록 취소가 완료될 때까지 Unload 함수에 대한 호출에서 반환하지 않아야 합니다.

참고 공급자 모듈이 Windows Driver Framework를 사용하는 경우 일반적으로 를 호출합니다. NmrDeregisterProvider function from its EvtDriverUnload event callback function. In this situation, the provider module must not return from a call to its EvtDriverUnload function until after deregistration is complete.

요구 사항

   
지원되는 최소 클라이언트 Windows Vista 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다.
대상 플랫폼 데스크톱
헤더 netioddk.h(Wsk.h 포함)
라이브러리 Netio.lib
IRQL <= DISPATCH_LEVEL

참고 항목

ClientDetachProvider

EvtDriverUnload

NmrRegisterProvider

NmrWaitForProviderDeregisterComplete

ProviderDetachClient

언로드