IQueueCallbackStateChange::OnStateChange-Methode (wudfddi.h)

Artikel
03/01/2024

[Warnung: UMDF 2 ist die neueste Version von UMDF und ersetzt UMDF 1. Alle neuen UMDF-Treiber sollten mit UMDF 2 geschrieben werden. UMDF 1 werden keine neuen Features hinzugefügt, und die Unterstützung für UMDF 1 für neuere Versionen von Windows 10 ist eingeschränkt. Universelle Windows-Treiber müssen UMDF 2 verwenden. Weitere Informationen finden Sie unter Erste Schritte mit UMDF.]

Die OnStateChange-Methode wird aufgerufen, wenn sich der Zustand des E/A-Warteschlangenobjekts ändert.

Syntax

void OnStateChange(
  [in] IWDFIoQueue        *pWdfQueue,
  [in] WDF_IO_QUEUE_STATE QueueState
);

Parameter

[in] pWdfQueue

Ein Zeiger auf die IWDFIoQueue-Schnittstelle für das E/A-Warteschlangenobjekt, dessen Zustand sich ändert.

[in] QueueState

Ein gültiger bitweiser OR mit WDF_IO_QUEUE_STATE typisierten Werten, der status für die Warteschlange angibt.

Rückgabewert

Keine

Bemerkungen

Ein Treiber registriert die IQueueCallbackStateChange-Schnittstelle , wenn der Treiber die IWDFDevice::CreateIoQueue-Methode aufruft, um eine E/A-Warteschlange zu erstellen oder die Standard-E/A-Warteschlange zu konfigurieren. Der Treiber kann optional die IQueueCallbackStateChange-Schnittstelle nur für eine manuelle Warteschlange registrieren. Der Treiber darf IQueueCallbackStateChange nicht für eine sequenzielle oder parallele Warteschlange registrieren.