PFN_WSK_SEND_MESSAGES Rückruffunktion (wsk.h)
Die WskSendMessages-Funktion sendet mehrere Datagramme an eine Remotetransportadresse.
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, von dem die Datagramme gesendet werden sollen.
[in] BufferList
Ein Zeiger auf eine initialisierte WSK_BUF_LIST Struktur, die die Liste der zu sendenden Datagramme enthält.
Flags
[Reserviert] Dieser Parameter ist für die Systemverwendung reserviert. Eine WSK-Anwendung muss diesen Parameter auf Null festlegen.
[in, optional] RemoteAddress
Ein Zeiger auf eine Struktur, die die Remotetransportadresse angibt, an die die Datagramme gesendet werden sollen.
[in] ControlInfoLength
Die Anzahl der Byte von Daten im Puffer, auf die der ControlInfo-Parameter verweist. Wenn dem Datagramm keine Steuerelementinformationen zugeordnet sind, muss der ControlInfoLength-Parameternull sein.
[In_reads_bytes_opt] ControlInfo
Ein Zeiger auf einen Puffer, der Steuerelementinformationen enthält, die den gesendeten Datagrammen zugeordnet sind. Die Steuerelementinformationsdaten bestehen aus einem oder mehreren Steuerelementdatenobjekten, von denen jedes mit einer CMSGHDR-Struktur beginnt. Wenn den Datagrammen keine Steuerelementinformationen zugeordnet sind, sollte dieser Parameter NULL sein.
ControlInfo wird möglicherweise nicht von allen Transporten unterstützt.
[in, out] Irp
Ein Zeiger auf eine vom Aufrufer zugewiesene IRP, die das WSK-Subsystem verwendet, um den Sendevorgang asynchron abzuschließen. Weitere Informationen zur Verwendung von IRPs mit WSK-Funktionen finden Sie unter Verwenden von IRPs mit Winsock-Kernelfunktionen.
Rückgabewert
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_SUCCESS | Die Datagramme wurden erfolgreich über den Socket gesendet. Die IRP wird erfolgreich status abgeschlossen. Das Feld IoStatus.Information 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. Die status des Sendevorgangs wird im Feld IoStatus.Status des IRP zurückgegeben. Wenn der Vorgang erfolgreich ist, enthält das Feld IoStatus.Information des IRP die Anzahl der gesendeten Bytes. |
| Andere status Codes | Ein Fehler ist aufgetreten. Die IRP wird mit einem Fehler status abgeschlossen. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 |
| Kopfzeile | wsk.h (include wsk.h) |