WdfIoQueueStart-Funktion (wdfio.h)

  • Artikel

[Gilt für KMDF und UMDF]

Die WdfIoQueueStart-Methode ermöglicht es einer E/A-Warteschlange, neue E/A-Anforderungen zu empfangen und zu übermitteln.

Syntax

void WdfIoQueueStart(
  [in] WDFQUEUE Queue
);

Parameter

[in] Queue

Ein Handle für ein Framework-Warteschlangenobjekt.

Rückgabewert

Keine

Bemerkungen

Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.

Wenn sich E/A-Anforderungen in der E/A-Warteschlange befinden, wenn der Treiber WdfIoQueueStart aufruft, kann derselbe Thread, der WdfIoQueueStart aufruft, die Anforderungshandler des Treibers aufrufen, bevor WdfIoQueueStart zurückgegeben wird. Wenn der Treiber WdfIoQueueStart aufruft, darf er daher keine Sperren enthalten, die die Anforderungshandler zu erwerben versuchen. Andernfalls kann es zu einem Deadlock kommen.

Weitere Informationen zur WdfIoQueueStart-Methode finden Sie unter Verwalten von E/A-Warteschlangen.

Beispiele

Im folgenden Codebeispiel wird eine angegebene E/A-Warteschlange gelöscht und anschließend die Warteschlange neu gestartet.

WdfIoQueuePurge(
                ReadQueue, 
                WDF_NO_EVENT_CALLBACK, 
                WDF_NO_CONTEXT
                );
WdfIoQueueStart(ReadQueue);

Anforderungen

Anforderung Wert
Zielplattform Universell
KMDF-Mindestversion 1.0
UMDF-Mindestversion 2.0
Kopfzeile wdfio.h (einschließen von Wdf.h)
Bibliothek Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL <= DISPATCH_LEVEL
DDI-Complianceregeln DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Weitere Informationen

WdfIoQueuePurge

WdfIoQueueStop