WdfIoQueueStart-Funktion (wdfio.h)
[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) |