IOCTL_UCMTCPCI_PORT_CONTROLLER_GET_STATUS IOCTL (ucmtcpciportcontrollerrequests.h)

Articolo
02/26/2024

Ottiene i valori di tutti i registri di stato in base alla specifica dell'interfaccia dell'interfaccia del controller di porta seriale universale-C. Il driver client deve recuperare i valori del CC_STATUS, POWER_STATUS e FAULT_STATUS registri.

Codice principale

IRP_MJ_DEVICE_CONTROL

Buffer di input

Puntatore a una struttura UCMTCPCI_PORT_CONTROLLER_GET_STATUS_IN_PARAMS che contiene tutti i valori del registro di controllo. Per ottenere la struttura, chiamare WdfRequestRetrieveInputBuffer passando l'oggetto richiesta del framework ricevuto.

Lunghezza del buffer di input

Dimensione della struttura UCMTCPCI_PORT_CONTROLLER_GET_STATUS_IN_PARAMS .

Buffer di output

Puntatore alla struttura UCMTCPCI_PORT_CONTROLLER_GET_STATUS_OUT_PARAMS . Per ottenere la struttura, chiamare WdfRequestRetrieveOutputBuffer passando l'oggetto richiesta del framework ricevuto.

Lunghezza del buffer di output

Dimensione della struttura UCMTCPCI_PORT_CONTROLLER_GET_STATUS_OUT_PARAMS .

Blocco dello stato

Irp->IoStatus.Status è impostato su STATUS_SUCCESS se la richiesta ha esito positivo. In caso contrario, stato della condizione di errore appropriata come codice NTSTATUS .

Commenti

L'estensione della classe UcmTcpciCx invia questa richiesta IOCTL per recuperare i valori dei registri di stato. Il driver client deve comunicare con il controller di porta per recuperare i valori del registro e popolare la struttura di UCMTCPCI_PORT_CONTROLLER_GET_STATUS_OUT_PARAMS ricevuta con tali valori. Per completare la richiesta, il driver deve impostare la struttura popolata nell'oggetto richiesta framework chiamando WdfRequestSetInformation e quindi chiamare WdfRequestComplete per completare la richiesta.