IOCTL_USB_REGISTER_FOR_TRANSPORT_CHARACTERISTICS_CHANGE IOCTL (usbioctl.h)
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 |
Confira também
Criando solicitações IOCTL em drivers
Drivers de cliente USB para Media-Agnostic (MA-USB)
WdfIoTargetSendInternalIoctlOthersSynchronously