IOMMU_INTERFACE_STATE_CHANGE_CALLBACK funzione di callback (wdm.h)

Articolo
02/29/2024

Questa routine viene richiamata ogni volta che è stata apportata una modifica dello stato del sistema che influisce su un DMA_IOMMU_INTERFACE_EX.

Sintassi

IOMMU_INTERFACE_STATE_CHANGE_CALLBACK IommuInterfaceStateChangeCallback;

void IommuInterfaceStateChangeCallback(
  PIOMMU_INTERFACE_STATE_CHANGE StateChange,
  PVOID Context
)
{...}

Parametri

StateChange

[In] Puntatore alle informazioni sullo stato che indicano quali stati sono stati modificati. Vedere IOMMU_INTERFACE_STATE_CHANGE.

Context

[In, facoltativo] Contesto facoltativo specificato dal chiamante che corrisponde al contesto facoltativo passato durante la registrazione di un callback dello stato dell'interfaccia IOMMU tramite IOMMU_REGISTER_INTERFACE_STATE_CHANGE_CALLBACK.

Valore restituito

nessuno

Osservazioni

Questo callback deve essere registrato tramite IOMMU_REGISTER_INTERFACE_STATE_CHANGE_CALLBACK. Verrà richiamato immediatamente al momento della registrazione (per evitare race condition) e ogni volta che si è verificata una modifica dello stato del sistema. Il proprietario del callback non deve presupporre lo stato e deve sempre controllare le informazioni sullo stato fornite in IOMMU_INTERFACE_STATE_CHANGE.

È responsabilità del proprietario del callback annullare la registrazione del callback, utilizzando IOMMU_UNREGISTER_INTERFACE_STATE_CHANGE_CALLBACK, prima di eliminare un DMA_IOMMU_INTERFACE_EX o un IOMMU_DMA_DEVICE.