WUDF_INTERRUPT_DISABLE Rückruffunktion (wudfinterrupt.h)

Die OnInterruptDisable Ereignisrückruffunktion eines Treibers deaktiviert einen angegebenen Hardwareunterbruch.

Syntax

WUDF_INTERRUPT_DISABLE WudfInterruptDisable;

HRESULT WudfInterruptDisable(
  [in] IWDFInterrupt *Interrupt,
  [in] IWDFDevice *AssociatedDevice
)
{...}

Parameter

[in] Interrupt

Ein Zeiger auf die IWDFInterrupt Schnittstelle.

[in] AssociatedDevice

Ein Zeiger auf die IWDFDevice Schnittstelle, die der Treiber zum Aufrufen CreateInterrupt-verwendet hat.

Rückgabewert

OnInterruptDisable muss S_OK zurückgeben, wenn der Vorgang erfolgreich ist. Andernfalls sollte der Rückruf einen der Fehlercodes zurückgeben, die in Winerror.h definiert sind.

Bemerkungen

Um eine OnInterruptDisable- Rückruffunktion zu registrieren, muss der Treiber die Adresse der Rückruffunktion in einer WUDF_INTERRUPT_CONFIG Struktur platzieren, bevor IWDFDevice::CreateInterruptaufgerufen wird.

Das Framework ruft die OnInterruptDisable Rückruffunktion des Treibers bei jedem Verlassen des Arbeitszustands (D0) auf. Darüber hinaus kann ein Treiber dazu führen, dass das Framework die OnInterruptDisable- Rückruffunktion aufruft, indem IWDFInterrupt::D isableaufgerufen wird.

Vor dem Aufrufen der OnInterruptDisable- Rückruffunktion ruft das Framework die OnD0ExitPreInterruptsDisabled Ereignisrückruffunktion auf und ruft die Unterbrechungssperre für den Benutzermodus ab.

Weitere Informationen zum Behandeln von Unterbrechungen in UMDF-Treibern finden Sie unter Zugreifen auf Hardware und Behandeln von Interrupts.

Beispiele

Der Funktionstyp wird wie folgt in Wudfinterrupt.hdeklariert.

typedef
__drv_functionClass(WUDF_INTERRUPT_DISABLE)
HRESULT
WUDF_INTERRUPT_DISABLE(
    _In_
    IWDFInterrupt* Interrupt,
    _In_
    IWDFDevice* AssociatedDevice
    );

typedef WUDF_INTERRUPT_DISABLE *PFN_WUDF_INTERRUPT_DISABLE;

Um eine OnInterruptDisable Rückruffunktion zu definieren, die MyInterruptDisableheißt, müssen Sie zunächst eine Funktionsdeklaration bereitstellen, die SDV und andere Überprüfungstools erfordern:

WUDF_INTERRUPT_DISABLE  MyInterruptDisable;

Implementieren Sie dann die Rückruffunktion wie folgt:

HRESULT
  MyInterruptDisable (
    IN IWDFInterrupt* pInterrupt,
    IN IWDFDevice*  pAssociatedDevice
    )
  {…}

Anforderungen

Siehe auch

• IWDFDevice::CreateInterrupt
• OnInterruptEnable-
• WUDF_INTERRUPT_CONFIG