Compartilhar via


IRP_MJ_SET_INFORMATION

Opcionalmente, os drivers de dispositivo podem lidar com uma solicitação de IRP_MJ_SET_INFORMATION .

Quando enviado

O sistema operacional envia uma solicitação IRP_MJ_SET_INFORMATION para definir metadados sobre um identificador de arquivo ou arquivo. Por exemplo, quando um driver chama ZwSetInformationFile, o sistema operacional envia uma solicitação de IRP_MJ_SET_INFORMATION .

Parâmetros de Entrada

O membro Parameters.SetFile.FileInformationClass é uma constante FILE_INFORMATION_CLASS que especifica o tipo de metadados a ser definido. Para obter mais informações sobre os tipos de metadados, consulte o parâmetro FileInformationClass de ZwSetInformationFile.

O membro Parameters.SetFile.Length especifica o comprimento do buffer para o qual o membro AssociatedIrp.SystemBuffer aponta.

AssociatedIrp.SystemBuffer aponta para o buffer que contém a nova configuração de informações. O valor de Parameters.SetFile.FileInformationClass determina o formato dos dados (uma estrutura FILE_XXX_INFORMATION ) a ser retornado. Para obter mais informações sobre os formatos dos metadados, consulte a enumeração FILE_INFORMATION_CLASS .

Parâmetros de saída

Nenhum

Operação

Os drivers não são necessários para lidar com essa solicitação e os drivers que não são necessários para lidar com todos os valores possíveis de Parameters.SetFile.FileInformationClass. A rotina de expedição do driver deve retornar um código de erro, como STATUS_INVALID_DEVICE_REQUEST para quaisquer valores que ele não manipula.

Nem todos os valores possíveis de FILE_INFORMATION_CLASS podem ocorrer.

Requisitos

parâmetro

Wdm.h (inclua Wdm.h, Ntddk.h ou Ntifs.h)

Confira também

ZwSetInformationFile