NetDmaProviderStop 함수(netdma.h)

아티클
08/07/2023

참고 NetDMA 인터페이스는 지원되지 않습니다.

Windows 8 이상에서

NetDmaProviderStop 함수는 NetDMA 인터페이스에 DMA 공급자와 연결된 모든 DMA 채널을 더 이상 DMA 전송에 사용할 수 없음을 알 수 있습니다.

구문

NET_DMA_EXPORT VOID NetDmaProviderStop(
  [in] PVOID NetDmaProviderHandle
);

매개 변수

[in] NetDmaProviderHandle

DMA 공급자를 식별하는 핸들입니다. DMA 공급자 드라이버는 에 대한 호출에서 NetDMA 인터페이스에서 이 핸들을 수신했습니다. NetDmaRegisterProvider 함수입니다.

반환 값

없음

설명

DMA 공급자 드라이버는 NetDmaProviderStop 함수를 호출하여 NetDMA 인터페이스에 NetDmaProviderStart 함수를 호출하여 시작된 DMA 엔진을 더 이상 사용할 수 없음을 알립니다.

DMA 공급자 드라이버는 NetDmaDeregisterProvider 함수를 호출하여 DMA 공급자 등록을 취소하기 전에 NetDmaProviderStop 을 호출해야 합니다.

DMA 공급자 드라이버는 일반적으로 IRP_MN_REMOVE_DEVICE 또는 IRP_MN_STOP_DEVICE IRP를 처리하는 동안 NetDmaProviderStop을 호출합니다.

DMA 공급자 드라이버는 DMA 공급자를 등록한 후 DMA 공급자를 등록하기 전에 애플리케이션에 필요한 횟수만큼 NetDmaProviderStop 및 NetDmaProviderStart 를 호출할 수 있습니다. NetDmaProviderStop을 호출한 후 DMA 엔진을 다시 시작하는 경우 DMA 공급자 드라이버는 에서 새 특성을 지정할 수 있습니다. NET_DMA_PROVIDER_ATTRIBUTES 구조체는 NetDmaProviderStart의 ProviderAttributes 매개 변수에 있습니다.

NetDMA 인터페이스는 미해결 DMA 작업이 완료되기를 기다렸다가 NetDmaProviderStop 함수에서 반환되기 전에 할당된 모든 DMA 채널을 해제합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista에서 NetDMA 1.0 드라이버에 대해 지원됩니다.
대상 플랫폼	유니버설
헤더	netdma.h(Netdma.h 포함)
IRQL	PASSIVE_LEVEL