Condividi tramite


IOCTL_SERIAL_GET_MODEM_CONTROL IOCTL (ntddser.h)

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

Per impostare il registro di controllo modem, un client può utilizzare 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 AssociatedIrp.SystemBuffer membro punta a un buffer ULONG allocato dal client utilizzato 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 una ULONG.

Blocco di stato

Se la richiesta ha esito positivo, il membro Information viene impostato sulle dimensioni, in byte, di una ULONG. In caso contrario, il membro Informazioni è impostato su zero.

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

Osservazioni

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 IOCTLs rischiano di dipendere dalle funzionalità hardware di un particolare controller seriale.

Per un esempio di layout 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.

Fabbisogno

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

Vedere anche

IOCTL_SERIAL_SET_MODEM_CONTROL