WdfIoQueueStart-Funktion (wdfio.h)

[Gilt für KMDF und UMDF]

Mit der WdfIoQueueStart--Methode kann eine E/A-Warteschlange beginnen, neue E/A-Anforderungen zu empfangen und zu übermitteln.

Syntax

VOID WdfIoQueueStart(
  [in] WDFQUEUE Queue
);

Die Parameter

[in] Queue

Ein Handle zu einem Framework-Warteschlangenobjekt.

Rückgabewert

Nichts

Bemerkungen

Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.

Wenn sich E/A-Anforderungen in der E/A-Warteschlange befinden, wenn der Treiber WdfIoQueueStartaufruft, kann derselbe Thread, der WdfIoQueueStart- aufruft, die Anforderungshandler des Treibers aufrufen, bevor WdfIoQueueStart zurückgibt. Wenn der Treiber WdfIoQueueStartaufruft, darf er daher keine Sperren enthalten, die die Anforderungshandler abrufen möchten. Andernfalls kann ein Deadlock ergebnisen.

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

Siehe auch

WdfIoQueuePurge-

WdfIoQueueStop-