LPFN_RIOCLOSECOMPLETIONQUEUE Rückruffunktion (mswsock.h)

Die RIOCloseCompletionQueue-Funktion schließt eine vorhandene Vervollständigungswarteschlange, die für E/A-Vervollständigungsbenachrichtigungen verwendet wird, indem Anforderungen mit den registrierten Winsock-E/A-Erweiterungen gesendet und empfangen werden.

Syntax

LPFN_RIOCLOSECOMPLETIONQUEUE LpfnRioclosecompletionqueue;

void LpfnRioclosecompletionqueue(
  RIO_CQ CQ
)
{...}

Parameter

CQ

Ein Deskriptor, der eine vorhandene Vervollständigungswarteschlange identifiziert.

Rückgabewert

Keine

Bemerkungen

Die RIOCloseCompletionQueue-Funktion schließt eine vorhandene Vervollständigungswarteschlange, die für die E/A-Vervollständigung verwendet wird. Die imCQ-Parameter übergebene RIO_CQ ist für das Schreiben durch den Kernel gesperrt. Die Vervollständigungswarteschlange ist als ungültig gekennzeichnet, sodass keine neuen Vervollständigungen hinzugefügt werden können. Alle neuen Vervollständigungen, die hinzugefügt werden sollen, werden automatisch gelöscht. Es wird erwartet, dass die Anwendung alle ausstehenden Sende- oder Empfangsvorgänge nachverfolgt.

Wenn eine ungültige Vervollständigungswarteschlange im CQ-Parameter (z. B. RIO_INVALID_CQ) übergeben wird, wird dies von der RIOCloseCompletionQueue-Funktion ignoriert.

Hinweis

Der Funktionszeiger auf die RIOCloseCompletionQueue-Funktion muss zur Laufzeit abgerufen werden, indem die WSAIoctl-Funktion mit dem angegebenen SIO_GET_MULTIPLE_EXTENSION_FUNCTION_POINTER opcode aufgerufen wird. Der an die WSAIoctl-Funktion übergebene Eingabepuffer muss WSAID_MULTIPLE_RIO enthalten, einen global eindeutigen Bezeichner (GUID), dessen Wert die von Winsock registrierten E/A-Erweiterungsfunktionen identifiziert. Bei Erfolg enthält die von der WSAIoctl-Funktion zurückgegebene Ausgabe einen Zeiger auf die RIO_EXTENSION_FUNCTION_TABLE-Struktur , die Zeiger auf die von Winsock registrierten E/A-Erweiterungsfunktionen enthält. Die SIO_GET_MULTIPLE_EXTENSION_FUNCTION_POINTER IOCTL ist in der Headerdatei Ws2def.h definiert. Die WSAID_MULTIPLE_RIO GUID ist in der Headerdatei "Mswsock.h " definiert.

 

Windows Phone 8: Diese Funktion wird für Windows Phone Store-Apps auf Windows Phone 8 und höher unterstützt.

Windows 8.1 und Windows Server 2012 R2: Diese Funktion wird für Windows Store-Apps auf Windows 8.1, Windows Server 2012 R2 und höher unterstützt.

Anforderungen

Anforderung	Wert
Header	mswsock.h