PFN_WSK_SEND_MESSAGES Rückruffunktion (wsk.h)
Die WskSendMessages--Funktion sendet mehrere Datagramme an eine Remote-Transportadresse.
Syntax
PFN_WSK_SEND_MESSAGES PfnWskSendMessages;
NTSTATUS PfnWskSendMessages(
[in] PWSK_SOCKET Socket,
[in] PWSK_BUF_LIST BufferList,
ULONG Flags,
[in, optional] PSOCKADDR RemoteAddress,
[in] ULONG ControlInfoLength,
[In_reads_bytes_opt] PCMSGHDR ControlInfo,
[in, out] PIRP Irp
)
{...}
Parameter
[in] Socket
Ein Zeiger auf eine WSK_SOCKET Struktur, die das Socketobjekt angibt, aus dem die Datagramme gesendet werden sollen.
[in] BufferList
Ein Zeiger auf eine initialisierte WSK_BUF_LIST Struktur, die die zu sendende Liste der zu sendenden Datagramme enthält.
Flags
[Reserviert] Dieser Parameter ist für die Systemverwendung reserviert. Eine WSK-Anwendung muss diesen Parameter auf nullfestlegen.
[in, optional] RemoteAddress
Ein Zeiger auf eine Struktur, die die Remotetransportadresse angibt, an die die Datagramme gesendet werden sollen.
[in] ControlInfoLength
Die Anzahl der Bytes von Daten im Puffer, auf die durch den parameter ControlInfo verwiesen wird. Wenn dem Datagramm keine Steuerelementinformationen zugeordnet sind, muss der parameter ControlInfoLength null sein.
[In_reads_bytes_opt] ControlInfo
Ein Zeiger auf einen Puffer, der Steuerelementinformationen enthält, die den zu sendenden Datagrammen zugeordnet sind. Die Steuerelementinformationsdaten bestehen aus einem oder mehreren Steuerelementdatenobjekten, die jeweils mit einer CMSGHDR- Struktur beginnen. Wenn keine Steuerelementinformationen vorhanden sind, die den Datagrammen zugeordnet sind, sollte dieser Parameter NULL-sein.
ControlInfo- werden möglicherweise nicht von allen Transporten unterstützt.
[in, out] Irp
Ein Zeiger auf ein vom Aufrufer zugewiesenes IRP, das vom WSK-Subsystem verwendet wird, um den Sendevorgang asynchron abzuschließen. Weitere Informationen zur Verwendung von IRPs mit WSK-Funktionen finden Sie unter Verwenden von IRPs mit Winsock Kernel Functions.
Rückgabewert
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_SUCCESS | Die Datagramme wurden erfolgreich über den Socket gesendet. Das IRP wird mit dem Erfolgsstatus abgeschlossen. Das IoStatus.Information Feld des IRP enthält die Anzahl der gesendeten Bytes. |
| STATUS_PENDING | Das WSK-Subsystem konnte die Datagramme nicht sofort über den Socket senden. Das WSK-Subsystem schließt das IRP ab, nachdem es die Datagramme über den Socket gesendet hat. Der Status des Sendevorgangs wird im feld IoStatus.Status IRP zurückgegeben. Wenn der Vorgang erfolgreich ist, enthält das IoStatus.Information Feld des IRP die Anzahl der gesendeten Bytes. |
| Andere Statuscodes | Fehler. Das IRP wird mit dem Fehlerstatus abgeschlossen. |
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 8 |
| Header- | wsk.h (include wsk.h) |