Função WdfDeviceSetSpecialFileSupport (wdfdevice.h)
[Aplica-se somente ao KMDF]
O método WdfDeviceSetSpecialFileSupport habilita ou desabilita o suporte de um driver de função para arquivos especiais para o dispositivo especificado.
Sintaxe
void WdfDeviceSetSpecialFileSupport(
[in] WDFDEVICE Device,
[in] WDF_SPECIAL_FILE_TYPE FileType,
[in] BOOLEAN FileTypeIsSupported
);
Parâmetros
[in] Device
Um identificador para um objeto de dispositivo de estrutura.
[in] FileType
Um enumerador tipo WDF_SPECIAL_FILE_TYPE que identifica o tipo de arquivo especial compatível com o driver.
[in] FileTypeIsSupported
Fornece um valor booliano que, se TRUE, habilita o suporte para o tipo de arquivo especial e, se FALSE, desabilita o suporte ao tipo de arquivo especial.
Retornar valor
Nenhum
Comentários
Um bug marcar ocorrerá se o driver fornecer um identificador de objeto inválido.
Um driver de função normalmente chama WdfDeviceSetSpecialFileSupport de dentro de sua função de retorno de chamada EvtDriverDeviceAdd .
O suporte de cada driver para arquivos especiais é inicialmente desabilitado até que o driver chame WdfDeviceSetSpecialFileSupport.
Para obter mais informações, consulte Suporte a arquivos especiais.
Exemplos
O exemplo de código a seguir permite suporte para paginação, hibernação e despejo de arquivos em um dispositivo.
WdfDeviceSetSpecialFileSupport(
device,
WdfSpecialFilePaging,
TRUE
);
WdfDeviceSetSpecialFileSupport(
device,
WdfSpecialFileHibernation,
TRUE
);
WdfDeviceSetSpecialFileSupport(
device,
WdfSpecialFileDump,
TRUE
);
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Universal |
| Versão mínima do KMDF | 1.0 |
| Cabeçalho | wdfdevice.h (inclua Wdf.h) |
| Biblioteca | Wdf01000.sys (consulte Controle de versão da biblioteca de estrutura.) |
| IRQL | <=DISPATCH_LEVEL |
| Regras de conformidade de DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |