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) |