PFN_WSK_SEND_MESSAGES Rückruffunktion (wsk.h)

Artikel
03/01/2024

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.