PFN_WSK_SEND_MESSAGES funzione di callback (wsk.h)
La funzione WskSendMessages invia più datagrammi a un indirizzo di trasporto remoto.
Sintassi
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
)
{...}
Parametri
[in] Socket
Puntatore a una struttura WSK_SOCKET che specifica l'oggetto socket da cui inviare i datagrammi.
[in] BufferList
Puntatore a una struttura WSK_BUF_LIST inizializzata che contiene l'elenco di datagrammi da inviare.
Flags
[Riservato] Questo parametro è riservato per l'uso del sistema. Un'applicazione WSK deve impostare questo parametro su zero.
[in, optional] RemoteAddress
Puntatore a una struttura che specifica l'indirizzo di trasporto remoto a cui inviare i datagrammi.
[in] ControlInfoLength
Numero di byte di dati nel buffer a cui punta il parametro ControlInfo . Se al datagram non sono associate informazioni di controllo, il parametro ControlInfoLength deve essere zero.
[In_reads_bytes_opt] ControlInfo
Puntatore a un buffer che contiene informazioni sul controllo associate ai datagrammi inviati. I dati delle informazioni sul controllo sono costituiti da uno o più oggetti dati di controllo, ognuno dei quali inizia con una struttura CMSGHDR . Se non sono presenti informazioni di controllo associate ai datagrammi, questo parametro deve essere NULL.
ControlInfo potrebbe non essere supportato da tutti i trasporti.
[in, out] Irp
Puntatore a un IRP allocato dal chiamante usato dal sottosistema WSK per completare l'operazione di invio in modo asincrono. Per altre informazioni sull'uso dei runtime di integrazione con le funzioni WSK, vedere Using IRPs with Winsock Kernel Functions .For more information about using IRPs with WSK functions, see Using IRPs with Winsock Kernel Functions.
Valore restituito
| Codice restituito | Descrizione |
|---|---|
| STATUS_SUCCESS | I datagrammi sono stati inviati correttamente sul socket. L'IRP verrà completato con lo stato di esito positivo. Il campo IoStatus.Information dell'IRP contiene il numero di byte inviati. |
| STATUS_PENDING | Il sottosistema WSK non è riuscito a inviare immediatamente i datagrammi sul socket. Il sottosistema WSK completerà l'IRP dopo aver inviato i datagrammi sul socket. Lo stato dell'operazione di invio verrà restituito nel campo IoStatus.Status dell'IRP. Se l'operazione ha esito positivo, il campo IoStatus.Information dell'IRP conterrà il numero di byte inviati. |
| Altri codici di stato | Si è verificato un errore. L'IRP verrà completato con lo stato di errore. |
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 8 |
| Intestazione | wsk.h (include wsk.h) |