PFN_WSK_SEND_MESSAGES funzione di callback (wsk.h)

  • Articolo

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)

Vedi anche

WSK_SOCKET

WSK_BUF_LIST

CMSGHDR

Uso dei runtime di integrazione con funzioni kernel Winsock