IOMMU_REGISTER_INTERFACE_STATE_CHANGE_CALLBACK Rückruffunktion (wdm.h)

Artikel
02/27/2024

Ermöglicht dem Aufrufer, einen Rückruf zu registrieren, der aufgerufen wird, wenn eine Zustandsänderung im Zusammenhang mit einem DMA_IOMMU_INTERFACE_EX erfolgt.

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 wird.

StateFields

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

Rückgabewert

STATUS_SUCCESS , wenn der Vorgang erfolgreich ist.

Mögliche Fehlerrückgabewerte umfassen die folgenden status-Codes.

Rückgabecode	Beschreibung
STATUS_UNSUCCESSFUL	Die Routine konnte den bereitgestellten Rückruf nicht registrieren, da der IOMMU_DMA_DEVICE bereits mit einem Rückruf registriert wurde.
STATUS_INVALID_PARAMETER_4	Der Aufrufer hat kein Interesse an einem Schnittstellenzustandsfeld in `StateFields`angegeben.

Weitere Informationen finden Sie unter NTSTATUS-Werte.

Hinweise

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

Vor dem Löschen eines DMA_IOMMU_INTERFACE_EX oder IOMMU_DMA_DEVICE ist der Besitzer dafür verantwortlich, die Registrierung aller registrierten Rückrufe aufzuheben.

Pro IOMMU_DMA_DEVICE kann nur ein Rückruf registriert werden.