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 essa IOCTL com uma estrutura SILO_DRIVER_CAPABILITES que indica se a autenticação e a faixa têm suporte, juntamente com uma lista de IOCTLs do EHSTOR que ele manipulará.

Código principal

IRP_MJ_DEVICE_CONTROL

Buffer de entrada

O buffer de entrada em Irp-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

A duração 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 .

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 tamanho 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.

Comentários

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 de 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 todas as 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.

As solicitações IOCTL compatíveis com 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 seus recursos usando esse IOCTL.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível a partir do Windows 8
Cabeçalho	ehstorioctl.h (inclua EhStorIoctl.h)

Confira também

SILO_DRIVER_CAPABILITIES