IOCTL_SERIAL_GET_MODEM_CONTROL IOCTL (ntddser.h)

La richiesta di IOCTL_SERIAL_GET_MODEM_CONTROL restituisce il valore del registro del controllo modem nel controller seriale.

Per impostare il registro di controllo modem, un client può usare una richiesta di IOCTL_SERIAL_SET_MODEM_CONTROL .

Codice principale

IRP_MJ_DEVICE_CONTROL

Buffer di input

Nessuno.

Lunghezza del buffer di input

Nessuno.

Buffer di output

Il membro AssociatedIrp.SystemBuffer punta a un buffer ULONG allocato dal client usato dal driver del controller seriale per restituire il valore del registro di controllo modem.

Lunghezza del buffer di output

Il membro Parameters.DeviceIoControl.OutputBufferLength è impostato sulle dimensioni, in byte, di un ULONG.

Blocco dello stato

Se la richiesta ha esito positivo, il membro Information è impostato sulla dimensione, in byte, di un ULONG. In caso contrario, il membro Information è impostato su zero.

Il membro Status è impostato su uno dei valori di stato generici per le richieste di controllo del dispositivo seriale.

Commenti

Le richieste di IOCTL_SERIAL_GET_MODEM_CONTROL e IOCTL_SERIAL_SET_MODEM_CONTROL vengono usate principalmente per i test hardware. Non è definito alcun layout di registro standard per le operazioni di controllo modem. I driver periferici che usano questi IOCTL rischiano di dipendere dalle funzionalità hardware di un determinato controller seriale.

Per un layout di esempio di un registro di controllo modem, vedere la definizione dei bit MCR (SERIAL_MCR_DTR tramite SERIAL_MCR_LOOP) nel file di intestazione Serial.h nell'esempio di driver seriale in GitHub.

Requisiti

Requisito	Valore
Intestazione	ntddser.h (include Ntddser.h)

Vedi anche

IOCTL_SERIAL_SET_MODEM_CONTROL