IQueueCallbackIoCanceledOnQueue::OnIoCanceledOnQueue-Methode (wudfddi.h)

[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 in neueren 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 OnIoCanceledOnQueue-Ereignisrückruffunktion eines Treibers informiert den Treiber darüber, dass eine E/A-Anforderung abgebrochen wurde, während sie sich in einer E/A-Warteschlange befand.

Syntax

void OnIoCanceledOnQueue(
  [in] IWDFIoQueue   *pWdfQueue,
  [in] IWDFIoRequest *pWdfRequest
);

Parameter

[in] pWdfQueue

Ein Zeiger auf die IWDFIoQueue-Schnittstelle für die E/A-Warteschlange, in der sich die E/A-Anforderung befand, als sie abgebrochen wurde.

[in] pWdfRequest

Ein Zeiger auf die IWDFIoRequest-Schnittstelle für die E/A-Anforderung.

Rückgabewert

Keine

Bemerkungen

Ein Treiber registriert die IQueueCallbackIoCanceledOnQueue-Schnittstelle und die OnIoCanceledOnQueue-Rückruffunktion einer E/A-Warteschlange, wenn der Treiber IWDFDevice::CreateIoQueue aufruft. Weitere Informationen zum Registrieren der Schnittstelle finden Sie unter IQueueCallbackIoCanceledOnQueue.

Wenn ein Treiber eine OnIoCanceledOnQueue-Rückruffunktion für eine E/A-Warteschlange registriert, ruft das Framework die Rückruffunktion auf, wenn ein Anforderungshandler eine E/A-Anforderung von einer E/A-Warteschlange empfängt, ruft der Treiber IWDFIoRequest::ForwardToIoQueue oder IWDFIoRequest2::Requeue auf, um die Anforderung erneut an die E/A-Warteschlange zu stellen, für die die OnIoCanceledOnQueue-Rückruffunktion registriert ist. und der zugeordnete E/A-Vorgang wird anschließend abgebrochen.

Nachdem das Framework die Rückruffunktion OnIoCanceledOnQueue aufgerufen hat , besitzt der Treiber das Anforderungsobjekt und muss daher die Anforderung abbrechen .

Das Framework ruft die OnIoCanceledOnQueue-Rückruffunktion des Treibers nicht für E/A-Anforderungen auf, die das Framework nie an den Treiber übermittelt hat.

Das Framework ruft eine OnIoCanceledOnQueue-Rückruffunktion auf, sobald festgestellt wird, dass eine E/A-Anforderung abgebrochen wurde, unabhängig von der Verteilmethode , die der Treiber für die E/A-Warteschlange festgelegt hat. Daher kann das Framework eine OnIoCanceledOnQueue-Rückruffunktion für eine Anforderung in einer Warteschlange aufrufen, die sequenzielle Verteilung verwendet, auch wenn der Treiber derzeit eine andere Anforderung aus der Warteschlange besitzt.

Weitere Informationen zur OnIoCanceledOnQueue-Rückruffunktion finden Sie unter Abbrechen von E/A-Anforderungen.

Anforderungen

Weitere Informationen

IQueueCallbackIoCanceledOnQueue

IWDFDevice::CreateIoQueue

IWDFIoRequest::ForwardToIoQueue