IOCTL_UCMTCPCI_PORT_CONTROLLER_GET_STATUS IOCTL (ucmtcpciportcontrollerrequests.h)

Artigo
02/29/2024

Obtém valores de todos os registros de status de acordo com a Especificação da Interface do Controlador de Porta Tipo C do Barramento Serial Universal. O driver do cliente deve recuperar os valores dos registros CC_STATUS, POWER_STATUS e FAULT_STATUS.

Código principal

IRP_MJ_DEVICE_CONTROL

Buffer de entrada

Um ponteiro para uma estrutura UCMTCPCI_PORT_CONTROLLER_GET_STATUS_IN_PARAMS que contém todos os valores de registro de controle. Para obter a estrutura, chame WdfRequestRetrieveInputBuffer passando o objeto de solicitação de estrutura recebida.

Comprimento do buffer de entrada

O tamanho da estrutura UCMTCPCI_PORT_CONTROLLER_GET_STATUS_IN_PARAMS .

Buffer de saída

Um ponteiro para a estrutura UCMTCPCI_PORT_CONTROLLER_GET_STATUS_OUT_PARAMS . Para obter a estrutura, chame WdfRequestRetrieveOutputBuffer passando o objeto de solicitação de estrutura recebida.

Comprimento do buffer de saída

O tamanho da estrutura UCMTCPCI_PORT_CONTROLLER_GET_STATUS_OUT_PARAMS .

Bloco de status

Irp->IoStatus.Status será definido como STATUS_SUCCESS se a solicitação for bem-sucedida. Caso contrário, Status para a condição de erro apropriada como um código NTSTATUS .

Comentários

A extensão de classe UcmTcpciCx envia essa solicitação IOCTL para recuperar os valores dos registros de status. O driver do cliente deve se comunicar com o controlador de porta para recuperar os valores de registro e preencher a estrutura de UCMTCPCI_PORT_CONTROLLER_GET_STATUS_OUT_PARAMS recebida com esses valores. Para concluir a solicitação, o driver deve definir a estrutura preenchida no objeto de solicitação de estrutura chamando WdfRequestSetInformation e, em seguida, chamar WdfRequestComplete para concluir a solicitação.