IOMMU_RESERVE_LOGICAL_ADDRESS_RANGE コールバック関数 (wdm.h)

[アーティクル]
02/27/2024

将来のマッピングに使用できる論理アドレス空間を事前割り当てします。これにより、ドライバーは、将来のマップ呼び出しまたはマップ解除呼び出しの転送の進行状況を保証する機能が付与されます。

構文

IOMMU_RESERVE_LOGICAL_ADDRESS_RANGE IommuReserveLogicalAddressRange;

NTSTATUS IommuReserveLogicalAddressRange(
  [in]           PIOMMU_DMA_DOMAIN Domain,
  [in]           SIZE_T Size,
  [in, optional] PIOMMU_DMA_LOGICAL_ADDRESS ExplicitLogicalAddress,
  [in, optional] PIOMMU_DMA_LOGICAL_ADDRESS MinLogicalAddress,
  [in, optional] PIOMMU_DMA_LOGICAL_ADDRESS MaxLogicalAddress,
  [out]          PIOMMU_DMA_LOGICAL_ADDRESS_TOKEN *LogicalAddressToken
)
{...}

パラメーター

[in] Domain

予約済み論理アドレスが属する IOMMU_DMA_DOMAIN へのポインター。ドメインの種類は DomainTypeTranslate である必要があります。ドメインの種類の詳細については、「 IOMMU_DMA_DOMAIN_TYPE」を参照してください。

[in] Size

予約する論理アドレス範囲のサイズ (バイト単位)。この値は、ページの総数を表す必要があります。

[in, optional] ExplicitLogicalAddress

予約する必要があるドメイン論理アドレス。ドメインが登録済みの論理アロケーターで作成されていない場合は、このフィールドが必要です。明示的な論理アドレス割り当てをサポートしない登録済み論理アロケーターを使用してドメインが作成された場合、このフィールドは NULL である必要があります。

[in, optional] MinLogicalAddress

予約可能な最小 (包括的) 許容論理アドレス。ドメインが登録済みの論理アロケーターで作成されていない場合、このフィールドは無視されます。

[in, optional] MaxLogicalAddress

予約できる最大 (包括的) 許容される論理アドレス。ドメインが登録済みの論理アロケーターで作成されていない場合、このフィールドは無視されます。

[out] LogicalAddressToken

予約済みの論理アドレス範囲を表す IOMMU_DMA_LOGICAL_ADDRESS_TOKEN を返します。

戻り値

操作が成功した場合にSTATUS_SUCCESSします。考えられるエラーの戻り値には、次の状態コードが含まれます。

リターンコード	説明
STATUS_INVALID_PARAMETER_1	指定されたドメインの種類が DomainTypeTranslate ではありません。
STATUS_INVALID_PARAMETER_2	指定されたサイズは、PAGE_SIZEの倍数ではありません。
STATUS_INVALID_PARAMETER_3	指定された ExplicitLogicalAddress はページアラインされていません。
STATUS_INVALID_PARAMETER_MIX	指定された最小論理アドレスと最大論理アドレスを満たできませんでした。
STATUS_IN_USE	ExplicitLogicalAddress は既にマップされているか、部分的にマップされています。
STATUS_NOT_SUPPORTED	明示的な論理アドレス割り当てを許可しない論理アロケーターを持つドメインに対して ExplicitLogicalAddress が提供されました。または、論理アロケーターがないドメインに ExplicitLogicalAddress が指定されませんでした。