WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT 함수(wdfdmaenabler.h)

[KMDF에만 적용]

WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT 함수는 드라이버의 WDF_DMA_SYSTEM_PROFILE_CONFIG 구조를 초기화합니다.

구문

void WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT(
       PWDF_DMA_SYSTEM_PROFILE_CONFIG  DmaConfig,
  [in] PHYSICAL_ADDRESS                Address,
  [in] DMA_WIDTH                       DmaWidth,
  [in] PCM_PARTIAL_RESOURCE_DESCRIPTOR DmaDescriptor
);

매개 변수

DmaConfig

드라이버 할당 WDF_DMA_SYSTEM_PROFILE_CONFIG 구조체에 대한 포인터입니다.

[in] Address

DMA를 대상으로 하는 레지스터의 번역된 주소입니다. 자세한 내용은 설명 부분을 참조하세요.

[in] DmaWidth

Address로 지정된 레지스터의 너비입니다.

[in] DmaDescriptor

EvtDevicePrepareHardware 중에 디바이스가 할당된 DMA 채널에 대한 번역된 리소스 설명자입니다.

반환 값

없음

설명

일반적으로 드라이버는 EvtDevicePrepareHardware 콜백 함수 내에서 WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT 호출합니다. 드라이버는 WdfDmaEnablerConfigureSystemProfile을 호출하기 전에 WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT 함수를 호출해야 합니다.

System on a Chip(SoC) 디자인에 따라 Address 매개 변수는 다른 의미를 가질 수 있습니다. 예를 들어 DMA가 디바이스에서 전용 전송 포트를 사용하는 경우 Address 는 DMA 쓰기가 발생하는 포트를 나타낼 수 있습니다.

시스템 모드 DMA 사용자를 만드는 방법에 대한 자세한 내용은 지원 System-Mode DMA를 참조하세요.

예제

WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT 사용하는 코드 예제는 WdfDmaEnablerConfigureSystemProfile을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 8
대상 플랫폼	유니버설
최소 KMDF 버전	1.11
머리글	wdfdmaenabler.h(Wdf.h 포함)

추가 정보

WDF_DMA_SYSTEM_PROFILE_CONFIG

WdfDmaEnablerConfigureSystemProfile

WdfDmaEnablerCreate