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_TYPEque identifica o tipo de arquivo especial compatível com o driver.

[in] FileTypeIsSupported

Fornece um valor booliano que, se VERDADEIRO, habilita o suporte para o tipo de arquivo especial e, se FALSE, desabilita o suporte ao tipo de arquivo especial.

Valor de retorno

Nenhum

Observações

Uma verificação de bug ocorre se o driver fornece 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 habilita o 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
da Plataforma de Destino Universal
versão mínima do KMDF 1.0
cabeçalho wdfdevice.h (inclua Wdf.h)
Biblioteca Wdf01000.sys (consulte o Controle de Versão da Biblioteca da Estrutura.)
IRQL <=DISPATCH_LEVEL
regras de conformidade de DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Consulte também

EvtDriverDeviceAdd

WDF_SPECIAL_FILE_TYPE