WDF_WMI_INSTANCE_CONFIG struttura (wdfwmi.h)

[Si applica solo a KMDF]

La struttura WDF_WMI_INSTANCE_CONFIG contiene informazioni di configurazione per un'istanza di un provider di dati WMI.

Sintassi

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;

Members

Size

Dimensione, in byte, della struttura.

Provider

Handle a un oggetto provider WMI ottenuto da un driver chiamando WdfWmiProviderCreate. Se questo membro è NULL, il membro ProviderConfig non deve essere NULL.

ProviderConfig

Puntatore a una struttura WDF_WMI_PROVIDER_CONFIG . Se questo membro è NULL, il membro del provider non deve essere NULL.

UseContextForQuery

Valore booleano che, se TRUE, indica che il driver archivierà i dati dell'istanza nell'oggetto contesto dell'istanza WMI e non fornirà una funzione di callback EvtWmiInstanceQueryInstance . Il framework, invece, eseguirà la richiesta di un client WMI per i dati dell'istanza inviando il contenuto dello spazio di contesto a WMI. Se questo membro è FALSE, il driver deve fornire una funzione di callback EvtWmiInstanceQueryInstance (a meno che i dati dell'istanza non siano di sola scrittura).

Se UseContextForQuery è TRUE, i dati dell'istanza devono essere di sola lettura e pertanto il driver non può fornire funzioni di callback EvtWmiInstanceSetInstance o EvtWmiInstanceSetItem.

Register

Valore booleano che, se TRUE, indica che il framework registra l'istanza del provider con il servizio WMI del sistema dopo la creazione di un oggetto istanza WMI WMI. Se questo membro è FALSE, il driver deve chiamare WdfWmiInstanceRegister per registrare l'istanza del provider.

EvtWmiInstanceQueryInstance

Puntatore alla funzione di callback EvtWmiInstanceQueryInstance per l'istanza del provider o NULL.

EvtWmiInstanceSetInstance

Puntatore alla funzione di callback EvtWmiInstanceSetInstance del driver per l'istanza del provider o NULL.

EvtWmiInstanceSetItem

Puntatore alla funzione di callback EvtWmiInstanceSetItem del driver per l'istanza del provider o NULL.

EvtWmiInstanceExecuteMethod

Puntatore alla funzione di callback EvtWmiInstanceExecuteMethod del driver per l'istanza del provider o NULL.

Commenti

La struttura WDF_WMI_INSTANCE_CONFIG viene usata come input per il metodo WdfWmiInstanceCreate .

Per inizializzare una struttura WDF_WMI_INSTANCE_CONFIG , il driver deve chiamare WDF_WMI_INSTANCE_CONFIG_INIT_PROVIDER o WDF_WMI_INSTANCE_CONFIG_INIT_PROVIDER_CONFIG.

Requisiti

Requisito Valore
Versione KMDF minima 1.0
Intestazione wdfwmi.h (include Wdf.h)

Vedi anche

EvtWmiInstanceExecuteMethod

EvtWmiInstanceQueryInstance

EvtWmiInstanceSetInstance

EvtWmiInstanceSetItem

WDF_WMI_INSTANCE_CONFIG_INIT_PROVIDER

WDF_WMI_INSTANCE_CONFIG_INIT_PROVIDER_CONFIG

WDF_WMI_PROVIDER_CONFIG

WdfWmiInstanceCreate

WdfWmiInstanceRegister

WdfWmiProviderCreate