IOMMU_DOMAIN_ATTACH_DEVICE_EX 콜백 함수(wdm.h)

아티클
02/07/2025

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

통사론

IOMMU_DOMAIN_ATTACH_DEVICE_EX IommuDomainAttachDeviceEx;

NTSTATUS IommuDomainAttachDeviceEx(
  PIOMMU_DMA_DOMAIN Domain,
  PIOMMU_DMA_DEVICE DmaDevice
)
{...}

매개 변수

Domain

[] IOMMU_DMA_DEVICE 연결할 도메인에 대한 핸들입니다.

DmaDevice

[] 연결할 IOMMU_DMA_DEVICE 대한 포인터입니다.

반환 값

작업이 성공했는지 STATUS_SUCCESS. 가능한 오류 반환 값에는 다음 상태 코드가 포함됩니다.

반환 코드	묘사
STATUS_INSUFFICIENT_RESOURCES	루틴에서 필요한 리소스를 할당하지 못했습니다.
STATUS_INVALID_PARAMETER	디바이스가 이미 도메인에 연결되어 있습니다.
STATUS_ACCESS_DENIED	디바이스는 현재 이 도메인 유형에 연결할 수 없습니다.

자세한 내용은 NTSTATUS 값참조하세요.

발언

호출자는 다른 도메인에 연결하기 전에 이전에 연결된 도메인에서 IOMMU_DOMAIN_DETACH_DEVICE_EX사용하여 IOMMU_DMA_DEVICE 먼저 분리되도록 할 책임이 있습니다.

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

STATUS_ACCESS_DENIED 반환되는 경우 현재 디바이스에서 연결할 도메인 유형을 사용할 수 없는 것일 수 있습니다. IOMMU_DEVICE_QUERY_DOMAIN_TYPES 활용하여 지정된 디바이스에 사용할 수 있는 도메인 유형을 결정하는 것이 좋습니다. 사용 가능한 형식은 DMA Guard 정책 및 디바이스 특성에 따라 달라질 수 있습니다. 도메인 유형을 사용할 수 있는 시기에 대한 알림을 받으려면 사용 가능한 도메인 유형이 변경될 때마다 IOMMU_REGISTER_INTERFACE_STATE_CHANGE_CALLBACK 사용하여 알림 콜백을 등록하는 것이 좋습니다.