Freigeben über

RtwqAllocateWorkQueue-Funktion (rtworkq.h)

  • Artikel

Erstellt eine neue Arbeitswarteschlange.

Syntax

HRESULT RtwqAllocateWorkQueue(
  [in]  RTWQ_WORKQUEUE_TYPE WorkQueueType,
  [out] DWORD               *workQueueId
);

Parameter

[in] WorkQueueType

Ein Member der RTWQ_WORKQUEUE_TYPE-Enumeration , das den Typ der zu erstellenden Arbeitswarteschlange angibt.

Wert Bedeutung
RTWQ_MULTITHREADED_WORKQUEUE
 Erstellen Sie eine Multithread-Arbeitswarteschlange. Im Allgemeinen sollten Anwendungen keine privaten Multithreadwarteschlangen erstellen. Verwenden Sie stattdessen die Plattform-Multithreadwarteschlangen.
RTWQ_STANDARD_WORKQUEUE
 Erstellen Sie eine Arbeitswarteschlange ohne Nachrichtenschleife. Die Verwendung dieses Flags entspricht dem Aufrufen von RtwqAllocateWorkQueue.
RTWQ_WINDOW_WORKQUEUE
 Erstellen Sie eine Arbeitswarteschlange mit einer Nachrichtenschleife. Der Thread, der die Arbeitselemente für diese Warteschlange verteilt, ruft auch PeekMessage und DispatchMessage auf. Verwenden Sie diese Option, wenn Ihr Rückruf Aktionen ausführt, die eine Nachrichtenschleife erfordern.

[out] workQueueId

Empfängt einen Bezeichner für die erstellte Arbeitswarteschlange.

Rückgabewert

Wenn diese Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8.1 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 R2 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile rtworkq.h
Bibliothek Rtworkq.lib
DLL RTWorkQ.dll