IOMMU_REGISTER_INTERFACE_STATE_CHANGE_CALLBACK Rückruffunktion (wdm.h)

Ermöglicht es dem Aufrufer, einen Rückruf zu registrieren, der aufgerufen werden kann, wenn statusänderungen im Zusammenhang mit einem DMA_IOMMU_INTERFACE_EX auftreten.

Syntax

IOMMU_REGISTER_INTERFACE_STATE_CHANGE_CALLBACK IommuRegisterInterfaceStateChangeCallback;

NTSTATUS IommuRegisterInterfaceStateChangeCallback(
  PIOMMU_INTERFACE_STATE_CHANGE_CALLBACK StateChangeCallback,
  PVOID Context,
  PIOMMU_DMA_DEVICE DmaDevice,
  PIOMMU_INTERFACE_STATE_CHANGE_FIELDS StateFields
)
{...}

Parameter

StateChangeCallback

[In] Die zu registrierende IOMMU_INTERFACE_STATE_CHANGE_CALLBACK.

Context

[In, optional] Ein optionaler Kontext, der an den Statusänderungsrückruf übergeben wird.

DmaDevice

[In] Ein Zeiger auf ein undurchsichtiges Token, das die IOMMU_DMA_DEVICE darstellt, die mit dem Rückruf verknüpft werden.

StateFields

[In] Ein Zeiger auf die Zustände, über die ein Anrufer registriert wird, um benachrichtigt zu werden. Siehe IOMMU_INTERFACE_STATE_CHANGE_FIELDS.

Rückgabewert

STATUS_SUCCESS, wenn der Vorgang erfolgreich ist.

Mögliche Fehlerrückgabewerte sind die folgenden Statuscodes.

Weitere Informationen finden Sie unter NTSTATUS Values.

Bemerkungen

Die Registrierung ruft den Rückruf immer sofort auf, um Racebedingungen mit allen Benachrichtigungen zu vermeiden, die die Rückrufe aufrufen. Rückrufbesitzer sollten nicht den Status annehmen, wenn ein Rückruf aufgerufen wird, und sollte immer überprüfen, ob der Zustand ihren Anforderungen entspricht.

Vor dem Entfernen einer DMA_IOMMU_INTERFACE_EX oder IOMMU_DMA_DEVICEist der Besitzer dafür verantwortlich, die Registrierung aller registrierten Rückrufe aufzuheben.

Pro IOMMU_DMA_DEVICEkann nur ein Rückruf registriert werden.

Anforderungen

Siehe auch

DMA_IOMMU_INTERFACE_V2

DMA_IOMMU_INTERFACE_EX

IOMMU_INTERFACE_STATE_CHANGE_CALLBACK

IOMMU_INTERFACE_STATE_CHANGE_FIELDS

IOMMU_UNREGISTER_INTERFACE_STATE_CHANGE_CALLBACK