LPFN_RIODEREGISTERBUFFER Rückruffunktion (mswsock.h)
Die RIODeregisterBuffer-Funktion hebt die Registrierung eines registrierten Puffers auf, der mit den registrierten Winsock-E/A-Erweiterungen verwendet wird.
Syntax
LPFN_RIODEREGISTERBUFFER LpfnRioderegisterbuffer;
void LpfnRioderegisterbuffer(
RIO_BUFFERID BufferId
)
{...}
Parameter
BufferId
Ein Deskriptor, der einen registrierten Puffer identifiziert.
Rückgabewert
Keine
Bemerkungen
Die RIODeregisterBuffer-Funktion hebt die Registrierung eines registrierten Puffers auf. Wenn ein Puffer aufgehoben wird, gibt die Anwendung an, dass dies mit dem Pufferbezeichner erfolgt, der im BufferId-Parameter übergeben wird. Alle nachfolgenden Aufrufe anderer Funktionen, die versuchen, diesen Pufferbezeichner zu verwenden, schlagen fehl.
Wenn ein noch verwendeter Puffer aufgehoben wird, sind die Ergebnisse nicht definiert. Dies gilt als schwerwiegender Fehler. In der RIORESULT-Struktur, die von der RIODequeueCompletion-Funktion zurückgegeben wird, bleibt der status gegenüber dem normalen status unverändert. Ein Anwendungsentwickler kann diese Fehlerbedingung mithilfe des Application Verifier-Tools erkennen.
Wenn ein ungültiger Pufferbezeichner im BufferId-Parameter übergeben wird, wird dies von der RIODeregisterBuffer-Funktion ignoriert.
Hinweis
Der Funktionszeiger auf die RIODeregisterBuffer-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 |