WdfDeviceSetSpecialFileSupport, fonction (wdfdevice.h)

Article
02/27/2024

[S’applique uniquement à KMDF]

La méthode WdfDeviceSetSpecialFileSupport active ou désactive la prise en charge d’un pilote de fonction pour les fichiers spéciaux, pour l’appareil spécifié.

Syntaxe

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

Paramètres

[in] Device

Handle d’un objet d’appareil framework.

[in] FileType

Énumérateur WDF_SPECIAL_FILE_TYPE qui identifie le type de fichier spécial pris en charge par le pilote.

[in] FileTypeIsSupported

Fournit une valeur booléenne qui, si TRUE, active la prise en charge du type de fichier spécial et, si FALSE, désactive la prise en charge du type de fichier spécial.

Valeur de retour

None

Remarques

Un bogue case activée se produit si le pilote fournit un handle d’objet non valide.

Un pilote de fonction appelle généralement WdfDeviceSetSpecialFileSupport à partir de sa fonction de rappel EvtDriverDeviceAdd .

La prise en charge de chaque pilote pour les fichiers spéciaux est initialement désactivée jusqu’à ce que le pilote appelle WdfDeviceSetSpecialFileSupport.

Pour plus d’informations, consultez Prise en charge des fichiers spéciaux.

Exemples

L’exemple de code suivant active la prise en charge des fichiers de pagination, de mise en veille prolongée et de vidage sur un appareil.

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

Configuration requise

Condition requise	Valeur
Plateforme cible	Universal
Version KMDF minimale	1.0
En-tête	wdfdevice.h (include Wdf.h)
Bibliothèque	Wdf01000.sys (consultez Gestion de version de la bibliothèque d’infrastructure.)
IRQL	<=DISPATCH_LEVEL
Règles de conformité DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Voir aussi

EvtDriverDeviceAdd

WDF_SPECIAL_FILE_TYPE

Partager via