IOMMU_INTERFACE_STATE_CHANGE_CALLBACK Rückruffunktion (wdm.h)

Artikel
03/05/2024

Diese Routine wird immer dann aufgerufen, wenn eine Systemzustandsänderung aufgetreten ist, die sich auf eine DMA_IOMMU_INTERFACE_EX auswirkt.

Syntax

IOMMU_INTERFACE_STATE_CHANGE_CALLBACK IommuInterfaceStateChangeCallback;

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

Parameter

StateChange

[In] Ein Zeiger auf die Zustandsinformationen, der angibt, welche Zustände sich geändert haben. Siehe IOMMU_INTERFACE_STATE_CHANGE.

Context

[In, optional] Ein optionaler vom Aufrufer angegebenen Kontext, der dem optionalen Kontext entspricht, der beim Registrieren eines IOMMU-Schnittstellenstatusänderungsrückrufs über IOMMU_REGISTER_INTERFACE_STATE_CHANGE_CALLBACK übergeben wurde.

Rückgabewert

Keine

Bemerkungen

Dieser Rückruf sollte über IOMMU_REGISTER_INTERFACE_STATE_CHANGE_CALLBACK registriert werden. Sie wird sofort bei der Registrierung (zur Vermeidung von Racebedingungen) und bei jeder Änderung des Systemzustands aufgerufen. Der Rückrufbesitzer sollte den Status nicht annehmen und die bereitgestellten Zustandsinformationen immer in IOMMU_INTERFACE_STATE_CHANGE überprüfen.

Es liegt in der Verantwortung des Rückrufbesitzers, die Registrierung des Rückrufs mithilfe von IOMMU_UNREGISTER_INTERFACE_STATE_CHANGE_CALLBACK aufzuheben, bevor ein DMA_IOMMU_INTERFACE_EX oder IOMMU_DMA_DEVICE.