Condividi tramite


struttura WDF_WMI_INSTANCE_CONFIG (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;

Membri

Size

Dimensione, in byte, di questa struttura.

Provider

Handle per un oggetto provider WMI ottenuto da un driver chiamando WdfWmiProviderCreare. 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 provider non deve essere NULL.

UseContextForQuery

Valore booleano che, se TRUE, indica che il driver archivierà i dati dell'istanza nello spazio di contesto dell'oggetto istanza WMI e non fornirà un EvtWmiInstanceQueryInstance funzione di callback. Al contrario, il framework 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 un EvtWmiInstanceQueryInstance funzione di callback (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 EvtWmiInstanceSetInstance o EvtWmiInstanceSetItem funzioni di callback.

Register

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

EvtWmiInstanceQueryInstance

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

EvtWmiInstanceSetInstance

Puntatore al EvtWmiInstanceSetInstance funzione di callback per l'istanza del provider oppure NULL.

EvtWmiInstanceSetItem

Puntatore al evtWmiInstanceSetItem del driver funzione di callback per l'istanza del provider oppure NULL.

EvtWmiInstanceExecuteMethod

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

Osservazioni

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

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

Fabbisogno

Requisito Valore
versione minima di KMDF 1.0
intestazione wdfwmi.h (include Wdf.h)

Vedere anche

EvtWmiInstanceExecuteMethod

EvtWmiInstanceQueryInstance

EvtWmiInstanceSetInstance

EvtWmiInstanceSetItem

WDF_WMI_INSTANCE_CONFIG_INIT_PROVIDER

WDF_WMI_INSTANCE_CONFIG_INIT_PROVIDER_CONFIG

WDF_WMI_PROVIDER_CONFIG

WdfWmiInstanceCreare

WdfWmiInstanceRegister

WdfWmiProviderCreare