IOCTL_USB_REGISTER_FOR_TRANSPORT_CHARACTERISTICS_CHANGE IOCTL (usbioctl.h)

Artigo
02/29/2024

Essa solicitação registra notificações sobre as alterações nas características de transporte.

Código principal

Buffer de entrada/saída

O membro AssociatedIrp.SystemBuffer é um ponteiro para uma estrutura USB_TRANSPORT_CHARACTERISTICS_CHANGE_REGISTRATION . Na entrada, o driver do cliente pode especificar o tipo de alterações de notificação nas quais o driver está interessado definindo os sinalizadores no membro ChangeNotificationInputFlags .

Na saída, a estrutura é preenchida com o identificador de registro e os valores iniciais das características de transporte.

Comprimento do buffer de entrada/saída

O tamanho da estrutura USB_TRANSPORT_CHARACTERISTICS_CHANGE_REGISTRATION .

Bloco de status

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

Comentários

As características de transporte de médias MA-USB podem variar significativamente ao longo do tempo. Se o mergulhador do cliente estiver interessado em saber as informações mais recentes o tempo todo, o driver deverá se registrar para notificação enviando a solicitação.

Essa solicitação pode ser enviada por um aplicativo de modo de usuário, um driver UMDF ou um driver KMDF. A pilha do driver USB verifica se há um identificador de registro obsoleto e incorreto. Se a solicitação for recebida em um identificador antes do registro e após o cancelamento do registro, a pilha de driver falhará na solicitação.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 10, versão 1709
Servidor mínimo com suporte	Windows Server 2016
Cabeçalho	usbioctl.h
IRQL	<=DISPATCH_LEVEL