IOCTL_EHSTOR_DRIVER_REPORT_CAPABILITIES IOCTL (ehstorioctl.h)
Esse IOCTL é usado para informar o driver de classe EHSTOR (armazenamento aprimorado) das funcionalidades do driver de silo. O driver de silo envia esse IOCTL com uma estrutura de SILO_DRIVER_CAPABILITES que indica se a autenticação e a banda têm suporte, juntamente com uma lista de IOCTLs EHSTOR que ele manipulará.
Código principal
Buffer de entrada
O buffer de entrada em > AssociatedIrp.SystemBuffer deve conter uma estrutura do tipo SILO_DRIVER_CAPABILITES. Essa estrutura é seguida imediatamente por uma lista de quais IOCTLs redirecionados o driver de silo manipulará.
Comprimento do buffer de entrada
O comprimento do buffer.
Buffer de saída
Nenhum.
Comprimento do buffer de saída
Nenhum.
Bloco de status
Um dos valores a seguir pode ser retornado no campo status do.
Valor do status | Descrição |
---|---|
STATUS_SUCCESS | Os recursos do driver de silo foram registrados com o driver de classe EHSTOR. |
STATUS_INVALID_BUFFER_SIZE | O comprimento do buffer de entrada fornecido é de tamanho incorreto. |
STATUS_INVALID_PARAMETER | Um parâmetro de funcionalidade está incorreto. |
STATUS_INSUFFICIENT_RESOURCES | A lista de redirecionamento IOCTL não pode ser copiada. |
STATUS_NOT_SUPPORTED | O dispositivo de envio não é um dispositivo de silo. |
Observações
Esse IOCTL é usado pelo driver de silo de autenticação padrão TCG (Trusted Computing Group) no Windows 8. Na inicialização do dispositivo, o driver de silo TCG notificará o driver de classe EHSTOR (EhStorClass.sys) de seus recursos enviando uma solicitação IOCTL_EHSTOR_DRIVER_REPORT_CAPABILITIES com uma estrutura de SILO_DRIVER_CAPABILITIES.
Os objetos do dispositivo Silo existem fora da pilha do dispositivo de armazenamento. Qualquer solicitação EHSTOR destinada a um driver de silo deve ser encaminhada explicitamente para ele. Esse é o caso de todos os IOCTLs de gerenciamento de banda. As solicitações de gerenciamento de banda são feitas em um objeto de arquivo que representa uma unidade física. Essas solicitações são enviadas pela pilha do dispositivo de armazenamento. Se o driver de silo tiver registrado suporte para o IOCTL, o driver de classe EHSTOR redirecionará a solicitação para o driver de silo.
Solicitações IOCTL com suporte por um driver de silo são incluídas em uma matriz após SILO_DRIVER_CAPABILITIES no buffer do sistema. O tamanho das informações no buffer do sistema deve ser especificado como sizeof(SILO_DRIVER_CAPABILITIES) + (sizeof(ULONG) * RedirectedIoctlListCount).
Um driver de silo de autenticação não TCG fornecido pelo fornecedor deve notificar o driver de classe EHSTOR de suas funcionalidades usando este IOCTL.
Requisitos
Requisito | Valor |
---|---|
de cliente com suporte mínimo | Disponível a partir do Windows 8 |
cabeçalho | ehstorioctl.h (inclua EhStorIoctl.h) |