LPFN_RIOSEND funzione di callback (mswsock.h)

La funzione RIOSend invia dati di rete su un socket TCP I/O registrato connesso o un socket UDP di I/O registrato associato per l'uso con le estensioni di I/O registrate winsock.

Sintassi

LPFN_RIOSEND LpfnRiosend;

BOOL LpfnRiosend(
  RIO_RQ SocketQueue,
  PRIO_BUF pData,
  ULONG DataBufferCount,
  DWORD Flags,
  PVOID RequestContext
)
{...}

Parametri

SocketQueue

Descrittore che identifica un socket TCP di I/O registrato connesso o un socket UDP di I/O registrato associato.

pData

Descrizione della parte del buffer registrato da cui inviare dati.

Questo parametro può essere NULL per un socket UDP di I/O registrato associato se l'applicazione non deve inviare un payload di dati nel datagramma UDP.

DataBufferCount

Parametro del conteggio del buffer dei dati che indica se i dati devono essere inviati nel buffer a cui punta il parametro pData .

Questo parametro deve essere impostato su zero se pData è NULL. In caso contrario, questo parametro deve essere impostato su 1.

Flags

Set di flag che modificano il comportamento della funzione RIOSend .

Il parametro Flags può contenere una combinazione delle opzioni seguenti, definite nel Mswsockdef.h file di intestazione:

RIO_MSG_COMMIT_ONLY

Verrà eseguito il commit delle richieste precedenti aggiunte con RIO_MSG_DEFER flag.

Quando il flag RIO_MSG_COMMIT_ONLY è impostato, non è possibile specificare altri flag. Quando il flag RIO_MSG_COMMIT_ONLY è impostato, gli argomenti pData e RequestContext devono essere NULL e l'argomento DataBufferCount deve essere zero.

Questo flag viene in genere usato occasionalmente dopo l'emissione di una serie di richieste con il flag RIO_MSG_DEFER impostato. In questo modo si elimina la necessità di usare il flag di RIO_MSG_DEFER per effettuare l'ultima richiesta senza il flag RIO_MSG_DEFER , causando il completamento dell'ultima richiesta molto più lentamente rispetto ad altre richieste.

A differenza di altre chiamate alla funzione RIOSend , quando il flag RIO_MSG_COMMIT_ONLY è impostato, non è necessario serializzare le chiamate alla funzione RIOSend . Per una singola RIO_RQ, è possibile chiamare la funzione RIOSend con RIO_MSG_COMMIT_ONLY in un thread chiamando la funzione RIOSend in un altro thread.

RIO_MSG_DONT_NOTIFY

La richiesta non deve attivare la funzione RIONotify quando il completamento della richiesta viene inserito nella relativa coda di completamento.

RIO_MSG_DEFER

La richiesta non deve essere eseguita immediatamente. La richiesta verrà inserita nella coda delle richieste, ma potrebbe attivare o meno l'esecuzione della richiesta.

L'invio di dati potrebbe essere ritardato fino a quando non viene effettuata una richiesta di invio sul RIO_RQ passato nel parametro SocketQueue senza il flag RIO_MSG_DEFER impostato. Per attivare l'esecuzione di tutti gli invii in una coda di invio, chiamare la funzione RIOSend o RIOSendEx senza il flag RIO_MSG_DEFER impostato.

Nota

La richiesta di invio viene addebitata in base alla capacità di I/O in sospeso nel RIO_RQ passato nel parametro SocketQueue , indipendentemente dal fatto che RIO_MSG_DEFER sia impostato.

RequestContext

Valore restituito

Se non si verifica alcun errore, la funzione RIOSend restituisce TRUE. In questo caso, l'operazione di invio viene avviata correttamente e il completamento sarà già stato accodato o l'operazione è stata avviata correttamente e il completamento verrà accodato in un secondo momento.

Un valore FALSE indica che la funzione non è riuscita, l'operazione non è stata avviata correttamente e non verrà accodata alcuna indicazione di completamento. È possibile recuperare un codice di errore specifico chiamando la funzione WSAGetLastError .

Codice restituito	Descrizione
WSAEFAULT	Il sistema ha rilevato un indirizzo puntatore non valido nel tentativo di usare un argomento puntatore in una chiamata. Questo errore viene restituito se un identificatore del buffer viene deregisterato o se un buffer viene liberato per una delle strutture RIO_BUF passate nei parametri prima che l'operazione venga accodata o richiamata.
WSAEINVAL	Alla funzione è stato passato un parametro non valido. Questo errore viene restituito se il parametro SocketQueue non è valido, il parametro Flags contiene un valore non valido per un'operazione di invio o l'integrità della coda di completamento è stata compromessa. Questo errore può essere restituito anche per altri problemi relativi ai parametri.
WSAENOBUFS	Impossibile allocare memoria sufficiente. Questo errore viene restituito se la coda di completamento di I/O associata al parametro SocketQueue è piena o la coda di completamento di I/O è stata creata con zero voci di invio.
WSA_IO_PENDING	L'operazione è stata avviata correttamente e il completamento verrà accodato in un secondo momento.

Commenti

Un'applicazione può usare la funzione RIOSend per inviare i dati di rete da qualsiasi buffer completamente contenuto all'interno di un singolo buffer registrato. I membri Offset e Length della struttura RIO_BUF a cui punta il parametro pData determinano i dati di rete da inviare dal buffer.

Il buffer associato a un'operazione di invio non deve essere utilizzato simultaneamente con un'altra operazione di invio o ricezione. Il buffer e la registrazione del buffer devono rimanere validi per la durata di un'operazione di invio. Ciò significa che non è consigliabile passare lo stesso PRIO_BUF a una richiesta RIOSend(Ex) quando ne è già in sospeso uno. Solo dopo il completamento di una richiesta RIOSend(Ex) in corso, è necessario riutilizzare lo stesso PRIO_BUF (con lo stesso offset o con un offset e una lunghezza diversi). Inoltre, quando l'invio di dati fa riferimento a un buffer registrato (una parte o l'intero buffer), l'intero buffer registrato non deve essere utilizzato fino al completamento dell'invio. Ciò include l'uso di una parte del buffer registrato per un'operazione di ricezione o un'altra operazione di invio.

Il parametro Flags può essere usato per influenzare il comportamento della funzione RIOSend oltre alle opzioni specificate per il socket associato. Il comportamento di questa funzione è determinato da una combinazione di qualsiasi opzione socket impostata sul socket associato al parametro SocketQueue e ai valori specificati nel parametro Flags .

Nota

Il puntatore di funzione alla funzione RIOSend deve essere ottenuto in fase di esecuzione effettuando una chiamata alla funzione WSAIoctl con il codice operativo SIO_GET_MULTIPLE_EXTENSION_FUNCTION_POINTER specificato. Il buffer di input passato alla funzione WSAIoctl deve contenere WSAID_MULTIPLE_RIO, un identificatore univoco globale (GUID) il cui valore identifica le funzioni di estensione I/O registrate winsock. In caso di esito positivo, l'output restituito dalla funzione WSAIoctl contiene un puntatore alla struttura RIO_EXTENSION_FUNCTION_TABLE che contiene puntatori alle funzioni di estensione di I/O registrate winsock. Il SIO_GET_MULTIPLE_EXTENSION_FUNCTION_POINTER IOCTL è definito nel file di intestazione Ws2def.h . Il GUID WSAID_MULTIPLE_RIO è definito nel file di intestazione Mswsock.h .

Windows Phone 8: questa funzione è supportata per le app dello Store di Windows Phone in Windows Phone 8 e versioni successive.

Windows 8.1 e Windows Server 2012 R2: questa funzione è supportata per le app di Windows Store in Windows 8.1, Windows Server 2012 R2 e versioni successive.

Requisiti

Requisito	Valore
Intestazione	mswsock.h