WDF_WMI_INSTANCE_CONFIG structure (wdfwmi.h)
[S’applique à KMDF uniquement]
La structure WDF_WMI_INSTANCE_CONFIG contient des informations de configuration pour un instance d’un fournisseur de données WMI.
Syntaxe
typedef struct _WDF_WMI_INSTANCE_CONFIG {
ULONG Size;
WDFWMIPROVIDER Provider;
PWDF_WMI_PROVIDER_CONFIG ProviderConfig;
BOOLEAN UseContextForQuery;
BOOLEAN Register;
PFN_WDF_WMI_INSTANCE_QUERY_INSTANCE EvtWmiInstanceQueryInstance;
PFN_WDF_WMI_INSTANCE_SET_INSTANCE EvtWmiInstanceSetInstance;
PFN_WDF_WMI_INSTANCE_SET_ITEM EvtWmiInstanceSetItem;
PFN_WDF_WMI_INSTANCE_EXECUTE_METHOD EvtWmiInstanceExecuteMethod;
} WDF_WMI_INSTANCE_CONFIG, *PWDF_WMI_INSTANCE_CONFIG;
Membres
Size
Taille, en octets, de cette structure.
Provider
Handle vers un objet de fournisseur WMI qu’un pilote a obtenu en appelant WdfWmiProviderCreate. Si ce membre a la valeur NULL, le membre ProviderConfig ne doit pas être NULL.
ProviderConfig
Pointeur vers une structure WDF_WMI_PROVIDER_CONFIG . Si ce membre a la valeur NULL, le membre fournisseur ne doit pas avoir la valeur NULL.
UseContextForQuery
Valeur booléenne qui, si elle est TRUE, indique que le pilote stockera instance données dans l’espace contextuel de l’objet WMI instance et ne fournira pas de fonction de rappel EvtWmiInstanceQueryInstance. Au lieu de cela, l’infrastructure prend en charge la demande d’instance données d’un client WMI en envoyant le contenu de l’espace contextuel à WMI. Si ce membre a la valeur FALSE, le pilote doit fournir une fonction de rappel EvtWmiInstanceQueryInstance (sauf si les données instance sont en écriture seule).
Si UseContextForQuery a la valeur TRUE, les données instance doivent être en lecture seule et, par conséquent, le pilote ne peut pas fournir des fonctions de rappel EvtWmiInstanceSetInstanceSetInstanceOu EvtWmiInstanceSetItem.
Register
Valeur booléenne qui, si elle est TRUE, indique que le framework inscrit le fournisseur instance auprès du service WMI du système après avoir créé un objet instance WMI. Si ce membre a la valeur FALSE, le pilote doit appeler WdfWmiInstanceRegister pour inscrire le fournisseur instance.
EvtWmiInstanceQueryInstance
Pointeur vers la fonction de rappel EvtWmiInstanceQueryInstance du pilote pour le fournisseur instance ou NULL.
EvtWmiInstanceSetInstance
Pointeur vers la fonction de rappel EvtWmiInstanceSetInstance du pilote pour le instance du fournisseur ou NULL.
EvtWmiInstanceSetItem
Pointeur vers la fonction de rappel EvtWmiInstanceSetItem du pilote pour le fournisseur instance, ou NULL.
EvtWmiInstanceExecuteMethod
Pointeur vers la fonction de rappel EvtWmiInstanceExecuteMethod du pilote pour le instance du fournisseur, ou NULL.
Remarques
La structure WDF_WMI_INSTANCE_CONFIG est utilisée comme entrée de la méthode WdfWmiInstanceCreate .
Pour initialiser une structure WDF_WMI_INSTANCE_CONFIG , votre pilote doit appeler WDF_WMI_INSTANCE_CONFIG_INIT_PROVIDER ou WDF_WMI_INSTANCE_CONFIG_INIT_PROVIDER_CONFIG.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Version KMDF minimale | 1.0 |
| En-tête | wdfwmi.h (inclure Wdf.h) |
Voir aussi
WDF_WMI_INSTANCE_CONFIG_INIT_PROVIDER