fonction de rappel EVT_WDF_WMI_PROVIDER_FUNCTION_CONTROL (wdfwmi.h)
[S’applique uniquement à KMDF]
La fonction de rappel EvtWmiProviderFunctionControl pilote active et désactive la prise en charge du pilote pour collecter des données et envoyer des événements pour un fournisseur de données WMI spécifié.
Syntaxe
EVT_WDF_WMI_PROVIDER_FUNCTION_CONTROL EvtWdfWmiProviderFunctionControl;
NTSTATUS EvtWdfWmiProviderFunctionControl(
[in] WDFWMIPROVIDER WmiProvider,
[in] WDF_WMI_PROVIDER_CONTROL Control,
[in] BOOLEAN Enable
)
{...}
Paramètres
[in] WmiProvider
Handle vers un objet fournisseur WMI.
[in] Control
Valeur WDF_WMI_PROVIDER_CONTROL-typée qui identifie une fonctionnalité que le pilote doit activer ou désactiver.
[in] Enable
Valeur booléenne qui, si TRUE, indique que le pilote doit activer la fonctionnalité spécifiée par Control. Si FALSE, le pilote doit désactiver la fonctionnalité.
Valeur de retour
La fonction de rappel EvtWmiProviderFunctionControl doit retourner STATUS_SUCCESS si l’opération réussit. Sinon, elle doit retourner une valeur d’état pour laquelle NT_SUCCESS('état) est égal à FALSE.
Remarques
Pour inscrire une fonction de rappel EvtWmiProviderFunctionControl, votre pilote doit placer l’adresse de la fonction dans une structure WDF_WMI_PROVIDER_CONFIG avant d’appeler WdfWmiProviderCreate.
Si votre pilote définit l’indicateur WdfWmiProviderExpensive dans l’indicateur Flags membre de la structure WDF_WMI_PROVIDER_CONFIG d’un fournisseur de données WMI et si le pilote fournit une EvtWmiProviderFunctionControl fonction de rappel, l’infrastructure appelle la fonction de rappel lorsque le pilote doit activer ou désactiver sa capacité à collecter des données WMI.
Au lieu de fournir une fonction de rappel EvtWmiProviderFunctionControl, le pilote peut appeler WdfWmiProviderIsEnabled pour savoir s’il doit activer ou désactiver la collecte de données.
Pour plus d’informations sur la fonction de rappel EvtWmiProviderFunctionControl, consultez Prise en charge de WMI dans Framework-Based Drivers.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Universel |
| version minimale de KMDF | 1.0 |
| d’en-tête | wdfwmi.h (include Wdf.h) |
| IRQL | PASSIVE_LEVEL |