Condividi tramite


Funzione WdfDeviceSetSpecialFileSupport (wdfdevice.h)

[Si applica solo a KMDF]

Il metodo WdfDeviceSetSpecialFileSupport abilita o disabilita il supporto di un driver di funzione per i file speciali per il dispositivo specificato.

Sintassi

VOID WdfDeviceSetSpecialFileSupport(
  [in] WDFDEVICE             Device,
  [in] WDF_SPECIAL_FILE_TYPE FileType,
  [in] BOOLEAN               FileTypeIsSupported
);

Parametri

[in] Device

Handle per un oggetto dispositivo framework.

[in] FileType

Enumeratore WDF_SPECIAL_FILE_TYPEtipizzato che identifica il tipo di file speciale supportato dal driver.

[in] FileTypeIsSupported

Fornisce un valore booleano che, se TRUE, abilita il supporto per il tipo di file speciale e, se FALSE, disabilita il tipo di file speciale.

Valore restituito

Nessuno

Osservazioni:

Se il driver fornisce un handle di oggetto non valido, si verifica un controllo di bug.

Un driver di funzione chiama in genere WdfDeviceSetSpecialFileSupport dall'interno del proprio EvtDriverDeviceAdd funzione di callback.

Il supporto di ogni driver per i file speciali viene inizialmente disabilitato fino a quando il driver non chiama WdfDeviceSetSpecialFileSupport.

Per altre informazioni, vedere supporto di file speciali.

Esempi

L'esempio di codice seguente abilita il supporto per il paging, l'ibernazione e i file di dump in un dispositivo.

WdfDeviceSetSpecialFileSupport(
                               device,
                               WdfSpecialFilePaging,
                               TRUE
                               );
WdfDeviceSetSpecialFileSupport(
                               device,
                               WdfSpecialFileHibernation,
                               TRUE
                               );
WdfDeviceSetSpecialFileSupport(
                               device,
                               WdfSpecialFileDump,
                               TRUE
                               );

Requisiti

Requisito Valore
Piattaforma di destinazione Universale
versione minima di KMDF 1.0
intestazione wdfdevice.h (include Wdf.h)
Biblioteca Wdf01000.sys (vedere Controllo delle versioni della libreria framework).
IRQL <=DISPATCH_LEVEL
regole di conformità DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Vedere anche

EvtDriverDeviceAdd

WDF_SPECIAL_FILE_TYPE