DMA_RESET_HANDLER 콜백 함수(netdma.h)

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

Windows 8 이상에서

 
ProviderResetChannel 함수는 DMA 채널을 할당한 후 존재했던 초기 상태로 DMA 채널을 다시 설정합니다.

구문

DMA_RESET_HANDLER DmaResetHandler;

NTSTATUS DmaResetHandler(
  [in] PVOID ProviderChannelContext
)
{...}

매개 변수

[in] ProviderChannelContext

DMA 채널의 컨텍스트 영역을 식별하는 포인터입니다. DMA 공급자는 의 pProviderChannelContext 매개 변수에 지정된 위치에 있는 NetDMA에 이 핸들을 반환했습니다. ProviderAllocateDmaChannel 함수입니다.

반환 값

ProviderResetChannel은 다음 상태 값 중 하나를 반환합니다.

반환 코드 설명
STATUS_SUCCESS
 작업이 성공적으로 완료되었습니다.
STATUS_UNSUCCESSFUL
 지정되지 않은 이유로 작업이 실패했습니다.

설명

ProviderResetChannel 함수는 NetDMA 공급자를 위한 선택적 함수입니다. NetDMA 인터페이스는 DMA 공급자 드라이버의 ProviderResetChannel 함수(있는 경우)를 호출하여 DMA 채널을 다시 설정합니다.

ProviderResetChannel에서 NetDMA 공급자는 현재 DMA 설명자와 연결된 데이터 전송을 완료하지 않고 활성 전송을 즉시 종료해야 합니다. 완료 상태 보고가 사용하도록 설정된 경우 DMA 엔진은 의 CompletionVirtualAddress 및 CompletionPhysicalAddress 멤버에 지정된 주소에 NetDmaTransferStatusHalted 상태 씁니다. NET_DMA_CHANNEL_PARAMETERS 구조체입니다.

다시 설정 작업이 완료되면 DMA 채널이 채널이 할당된 후 존재했던 초기 상태여야 합니다. NetDMA 인터페이스가 ProviderResetChannel을 호출한 후에는 DMA 공급자가 이전에 제출한 DMA 설명자에 액세스할 수 없습니다. DMA 채널은 NetDMA 인터페이스가 ProviderStartDma 함수를 호출할 준비가 되어 있어야 합니다.

NetDMA는 IRQL <= DISPATCH_LEVEL ProviderResetChannel을 호출합니다.

요구 사항

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

추가 정보

NET_DMA_CHANNEL_PARAMETERS

ProviderAllocateDmaChannel

ProviderStartDma