IOMMU_DOMAIN_ATTACH_DEVICE 콜백 함수(wdm.h)

디바이스를 기존 도메인에 연결합니다.

구문

IOMMU_DOMAIN_ATTACH_DEVICE IommuDomainAttachDevice;

NTSTATUS IommuDomainAttachDevice(
  [_In_] PIOMMU_DMA_DOMAIN Domain,
  [_In_] PDEVICE_OBJECT PhysicalDeviceObject,
  [_In_] ULONG InputMappingIdBase,
  [_In_] ULONG MappingCount
)
{...}

매개 변수

[_In_] Domain

도메인에 대한 핸들에 대한 포인터입니다.

[_In_] PhysicalDeviceObject

디바이스의 디바이스 스택에 있는 PDO(물리적 디바이스 개체)를 가리키는 포인터입니다.

[_In_] InputMappingIdBase

디바이스의 원하는 스트림에 대한 입력 매핑 기준입니다.

[_In_] MappingCount

베이스에서 시작하는 매핑의 수입니다.

반환 값

작업이 성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 적절한 NTSTATUS 값 오류 코드를 반환합니다. 자세한 내용은 NTSTATUS 값을 참조하세요.

설명

이 함수가 동일한 디바이스에서 IOMMU_DOMAIN_DETACH_DEVICE 또는 IOMMU_SET_DEVICE_FAULT_REPORTING 호출과 동시에 호출되지 않도록 하는 것은 드라이버의 책임입니다.

InputMappingIdBase 및 MappingCount 는 ARM64에서 여러 스트림 ID를 지원하는 ACPI 열거형 디바이스를 수용하기 위한 것입니다. 다른 디바이스 또는 아키텍처의 경우 다음 값이 있어야 합니다.

• InputMappingIdBase = 0

• MappingCount = 1

이 방법은 더 이상 사용되지 않습니다. IOMMU_DOMAIN_ATTACH_DEVICE_EX 및 DMA_IOMMU_INTERFACE_EX 사용하는 것이 좋습니다.

요구 사항