WdfDeviceMapIoSpace 함수(wdfdevice.h)

[UMDF에만 적용]

WdfDeviceMapIoSpace 함수는 지정된 실제 주소 범위를 시스템 주소 공간에 매핑하고 의사 기본 주소를 반환합니다.

통사론

NTSTATUS WdfDeviceMapIoSpace(
  [in]  WDFDEVICE           Device,
  [in]  PHYSICAL_ADDRESS    PhysicalAddress,
  [in]  SIZE_T              NumberOfBytes,
  [in]  MEMORY_CACHING_TYPE CacheType,
  [out] PVOID               *PseudoBaseAddress
);

매개 변수

[in] Device

프레임워크 디바이스 개체에 대한 핸들입니다.

[in] PhysicalAddress

매핑할 I/O 범위의 시작 64비트 물리적 주소를 지정합니다.

[in] NumberOfBytes

매핑할 바이트 수를 나타내는 0보다 큰 값을 지정합니다.

[in] CacheType

실제 주소 범위를 매핑하는 데 사용할 캐시 특성을 나타내는 MEMORY_CACHING_TYPE 값을 지정합니다. MEMORY_CACHING_TYPE 열거형 형식은 Wdfdevice.h에 정의되어 있습니다.

[out] PseudoBaseAddress

의사 기준 주소에 대한 포인터를 받는 위치의 주소입니다.

반환 값

작업이 성공하면 함수는 STATUS_SUCCESS 반환합니다.

함수는다른 NTSTATUS 값을 반환할 수 있습니다.

발언

이 함수는 IWDFDevice3::MapIoSpace해당하는 UMDF 버전 2입니다.

드라이버는 CM_PARTIAL_RESOURCE_DESCRIPTOR 구조에서 cmResourceTypeMemory 형식의 변환된 리소스를 수신하는 경우 디바이스를 시작하는 동안 이 함수를 호출해야 합니다. WdfDeviceMapIoSpace 리소스 목록에 반환된 실제 주소를 의사 기본 주소라고 하는 프레임워크 관리형 주소에 매핑합니다.

그런 다음 드라이버는 의사 기준 주소를 사용하여 WDF_READ_REGISTER_Xxx 사용하여 디바이스 레지스터에 액세스하고 Xxx 함수를 WDF_WRITE_REGISTER_수 있습니다.

WdfDeviceMapIoSpace 호출하는 드라이버는 UmdfDirectHardwareAccess INF 지시문을 AllowDirectHardwareAccess설정해야 합니다.

드라이버가 UmdfRegisterAccessMode INF 지시문을 registerAccessUsingUserModeMapping설정하면 WdfDe를 호출합니다. 또한viceMapIoSpace 지정된 실제 주소 범위를WdfDeviceGetHardwareRegisterMappedAddress를 호출하여 드라이버가 이후에 액세스할 수 있는 사용자 모드 기본 주소 범위에 매핑합니다.

UMDF 드라이버에서 사용할 수 있는 INF 지시문에 대한 자세한 내용은 INF 파일WDF 지시문 지정을 참조하세요.

UMDF 버전 2부터 하드웨어 리소스를 구문 분석하는 방법에 대한 자세한 내용은 UMDF 드라이버하드웨어 리소스 처리를 참조하세요.

PHYSICAL_ADDRESS 형식은 다음과 같이 Wudfwdm.h에 정의됩니다.

typedef LARGE_INTEGER PHYSICAL_ADDRESS;

드라이버가 메모리 매핑된 레지스터 리소스를 찾고 매핑하는 방법을 보여 주는 예제는 디바이스 레지스터읽기 및 쓰기를 참조하세요.

요구 사항

요구	값
지원되는 최소 클라이언트	Windows 8.1
대상 플랫폼	보편적
최소 UMDF 버전	2.0
헤더	wdfdevice.h(Wdf.h 포함)
라이브러리	WUDFx02000.lib
DLL	WUDFx02000.dll
IRQL	PASSIVE_LEVEL

참고 항목

IWDFDevice3::MapIoSpace

WdfDeviceUnmapIoSpace