Funzione SetupComm (winbase.h)
Inizializza i parametri di comunicazione per un dispositivo di comunicazione specificato.
Sintassi
BOOL SetupComm(
[in] HANDLE hFile,
[in] DWORD dwInQueue,
[in] DWORD dwOutQueue
);
Parametri
[in] hFile
Handle per il dispositivo di comunicazione. La funzione CreateFile restituisce questo handle.
[in] dwInQueue
Dimensioni consigliate del buffer di input interno del dispositivo, in byte.
[in] dwOutQueue
Dimensioni consigliate del buffer di output interno del dispositivo, in byte.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è diverso da zero.
Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.
Commenti
Dopo che un processo usa la funzione CreateFile per aprire un handle a un dispositivo di comunicazione, ma prima di eseguire qualsiasi I/O con il dispositivo, può chiamare SetupComm per impostare i parametri di comunicazione per il dispositivo. Se non li imposta, il dispositivo usa i parametri predefiniti quando si verifica la prima chiamata a un'altra funzione di comunicazione.
I parametri dwInQueue e dwOutQueue specificano le dimensioni consigliate per i buffer interni usati dal driver per il dispositivo specificato. Ad esempio, i pacchetti di protocolli YMODEM sono leggermente maggiori di 1024 byte. Pertanto, una dimensione del buffer consigliata potrebbe essere di 1200 byte per le comunicazioni YMODEM. Per le comunicazioni basate su Ethernet, una dimensione del buffer consigliata potrebbe essere di 1600 byte, che è leggermente maggiore di un singolo frame Ethernet.
Il driver di dispositivo riceve le dimensioni del buffer consigliate, ma è libero di usare qualsiasi schema di buffering di input e output (I/O), purché fornisca prestazioni ragionevoli e i dati non vengano persi a causa dell'overrun (ad eccezione di circostanze estreme). Ad esempio, la funzione può avere esito positivo anche se il driver non alloca un buffer, purché alcune altre parti del sistema forniscano funzionalità equivalenti.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows XP [app desktop | App UWP] |
| Server minimo supportato | Windows Server 2003 [app desktop | App UWP] |
| Piattaforma di destinazione | Windows |
| Intestazione | winbase.h (include Windows.h) |
| Libreria | Kernel32.lib |
| DLL | Kernel32.dll |