IOMMU_MAP_RESERVED_LOGICAL_RANGE funzione di callback (wdm.h)
Esegue il mapping di un intervallo logico riservato.
A differenza di IOMMU_MAP_LOGICAL_RANGE_EX, è garantito che non esegua alcuna allocazione di memoria perché si presuppone che siano già state eseguite in precedenza con IOMMU_RESERVE_LOGICAL_ADDRESS_RANGE.
Sintassi
IOMMU_MAP_RESERVED_LOGICAL_RANGE IommuMapReservedLogicalRange;
NTSTATUS IommuMapReservedLogicalRange(
[in, out] PIOMMU_DMA_LOGICAL_ADDRESS_TOKEN LogicalAddressToken,
[in] SIZE_T Offset,
[in] ULONG Permissions,
[in] PIOMMU_MAP_PHYSICAL_ADDRESS PhysicalAddressToMap,
[out] PIOMMU_DMA_LOGICAL_ADDRESS_TOKEN_MAPPED_SEGMENT MappedSegment
)
{...}
Parametri
[in, out] LogicalAddressToken
Oggetto IOMMU_DMA_LOGICAL_ADDRESS_TOKEN a cui eseguire il mapping.
[in] Offset
Offset, in byte, nel token di indirizzo logico che rappresenta l'indirizzo logico di base da eseguire il mapping.
[in] Permissions
Campo bit che rappresenta le autorizzazioni da impostare per l'intervallo mappato. Vedere Osservazioni per i bit di autorizzazione disponibili.
[in] PhysicalAddressToMap
Il IOMMU_MAP_PHYSICAL_ADDRESS che verrà mappato al dominio.
[out] MappedSegment
Restituisce l'IOMMU_DMA_LOGICAL_ADDRESS_TOKEN_MAPPED_SEGMENT che rappresenta un segmento del token di indirizzo logico ora mappato.
Valore restituito
STATUS_SUCCESS se l'operazione ha esito positivo. I valori restituiti degli errori possibili includono i codici di stato seguenti.
| Codice restituito | Descrizione |
|---|---|
| STATUS_INVALID_PARAMETER_2 | L'offset specificato non è allineato alla pagina. |
| STATUS_INVALID_PARAMETER_4 | L'indirizzo fisico specificato non è allineato a pagina e/o non è un numero intero di pagine di dimensioni. |
| STATUS_RESOURCE_IN_USE | L'intervallo di indirizzi logici rappresentato nel token di indirizzo logico è già completamente o parzialmente mappato. |
| STATUS_UNSUCCESSFUL | Il token di indirizzo logico è attualmente in corso di eliminazione. |
Per altre informazioni, vedere Valori NTSTATUS.
Commenti
È possibile annullare il mapping di un segmento di token di indirizzo logico tramite IOMMU_UNMAP_RESERVED_LOGICAL_RANGE.
Il campo autorizzazioni è un campo bit che descrive le autorizzazioni di accesso per le pagine da mappare.
I bit sono definiti come segue:
Bit 0 = Read Access
Bit 1 = Write Access
Bits 31-2 = Reserved (0)
Requisiti
| Requisito | Valore |
|---|---|
| Server minimo supportato | Windows Server 2022 |
| Intestazione | wdm.h (include Wdm.h) |
Vedi anche
IOMMU_UNMAP_RESERVED_LOGICAL_RANGE