Compartilhar via


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)

Confira também

EvtDriverDeviceAdd

WDF_SPECIAL_FILE_TYPE