PFN_WSK_SEND_BACKLOG_EVENT funzione di callback (wsk.h)
La funzione di callback dell'evento WskSendBacklogEvent notifica a un'applicazione WSK quando le dimensioni del backlog ideali vengono inviate per un socket orientato alla connessione.
Sintassi
PFN_WSK_SEND_BACKLOG_EVENT PfnWskSendBacklogEvent;
NTSTATUS PfnWskSendBacklogEvent(
[in, optional] PVOID SocketContext,
[in] SIZE_T IdealBacklogSize
)
{...}
Parametri
[in, optional] SocketContext
Puntatore al contesto del socket per il socket orientato alla connessione che informa l'applicazione WSK su una modifica alla dimensione ideale del backlog di invio. L'applicazione WSK ha fornito questo puntatore al sottosistema WSK in uno dei modi seguenti:
- Ha chiamato la funzione WskSocket per creare il socket.
- Ha chiamato la funzione WskSocketConnect per creare il socket.
- Ha chiamato la funzione WskAccept per accettare il socket come connessione in ingresso.
- La funzione di callback dell'evento WskAcceptEvent è stata chiamata per accettare il socket come connessione in ingresso.
[in] IdealBacklogSize
Variabile contenente la nuova dimensione del backlog di invio ideale.
Valore restituito
La funzione di callback dell'evento WskSendBacklogEvent dell'applicazione WskSendBacklogEvent deve restituire sempre STATUS_SUCCESS.
Commenti
Il sottosistema WSK chiama la funzione di callback dell'evento WskSendBacklogEvent dell'applicazione WskSendBacklogEvent quando la dimensione del backlog ideale invia le modifiche per un socket orientato alla connessione solo se la funzione di callback dell'evento è stata abilitata in precedenza con l'opzione socket SO_WSK_EVENT_CALLBACK . Per altre informazioni sull'abilitazione delle funzioni di callback degli eventi di un socket, vedere Abilitazione e disabilitazione delle funzioni di callback degli eventi.
La dimensione ideale del backlog di invio per un socket orientato alla connessione è la quantità ottimale di dati di invio che devono essere mantenuti in sospeso (ovvero passati al sottosistema WSK ma non ancora completati) per mantenere il flusso di dati del socket pieno in ogni momento. Un'applicazione WSK può usare questa dimensione per eseguire il probe incrementale e bloccare i buffer di dati da inviare in base allo stato di controllo del flusso della connessione sottostante.
Un'applicazione WSK può ottenere la dimensione del backlog ideale corrente per un socket orientato alla connessione in qualsiasi momento chiamando la funzione WskControlSocket .
Il sottosistema WSK chiama la funzione di callback dell'evento WskSendBacklogEvent di WskSendBacklogEvent in IRQL <= DISPATCH_LEVEL.
La funzione di callback dell'evento WskSendBacklogEvent dell'applicazione WskSendBacklogEvent non deve attendere il completamento di altre richieste WSK nel contesto delle funzioni di completamento o callback dell'evento WSK. Il callback può avviare altre richieste WSK (presupponendo che non spenda troppo tempo in DISPATCH_LEVEL), ma non deve attendere il completamento anche quando il callback viene chiamato in IRQL = PASSIVE_LEVEL.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows. |
| Piattaforma di destinazione | Windows |
| Intestazione | wsk.h (include Wsk.h) |
| IRQL | <= DISPATCH_LEVEL |