Funzione WdfDeviceSetSpecialFileSupport (wdfdevice.h)

[Si applica solo a KMDF]

Il metodo WdfDeviceSetSpecialFileSupport abilita o disabilita il supporto di un driver di funzione per 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_TYPE tipizzato 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

Un controllo di bug si verifica se il driver fornisce un handle di oggetti non valido.

Un driver di funzione chiama in genere WdfDeviceSetSpecialFileSupport dall'interno della relativa funzione EvtDriverDeviceAdd callback.

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

Per altre informazioni, vedere Supporto di file speciali.

Esempio

Nell'esempio di codice seguente è possibile supportare 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 KMDF minima	1.0
Intestazione	wdfdevice.h (includere Wdf.h)
Libreria	Wdf01000.sys (vedere Framework Library Versioning).
IRQL	<=DISPATCH_LEVEL
Regole di conformità DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Vedi anche

EvtDriverDeviceAdd

WDF_SPECIAL_FILE_TYPE