función WDF_WMI_INSTANCE_CONFIG_INIT_PROVIDER (wdfwmi.h)

Artículo
03/05/2024

[Solo se aplica a KMDF]

La función WDF_WMI_INSTANCE_CONFIG_INIT_PROVIDER inicializa una estructura de WDF_WMI_INSTANCE_CONFIG y almacena un identificador especificado en un objeto de proveedor WMI.

Sintaxis

void WDF_WMI_INSTANCE_CONFIG_INIT_PROVIDER(
  [out] PWDF_WMI_INSTANCE_CONFIG Config,
  [in]  WDFWMIPROVIDER           Provider
);

Parámetros

[out] Config

Puntero a una estructura de WDF_WMI_INSTANCE_CONFIG .

[in] Provider

Identificador de un objeto de proveedor WMI que el controlador obtuvo mediante una llamada anterior a WdfWmiProviderCreate.

Valor devuelto

None

Observaciones

La función WDF_WMI_INSTANCE_CONFIG_INIT_PROVIDER cero la estructura WDF_WMI_INSTANCE_CONFIG que el parámetro Config especifica y establece su miembro Size . Esta función también establece el miembro Provider de la estructura en el identificador que especifica el parámetro Provider .

El controlador debe llamar a WDF_WMI_INSTANCE_CONFIG_INIT_PROVIDER para inicializar una estructura de WDF_WMI_INSTANCE_CONFIG si llama a WdfWmiProviderCreate antes de llamar a WdfWmiInstanceCreate.

Ejemplos

En el ejemplo de código siguiente se inicializa una estructura de WDF_WMI_PROVIDER_CONFIG y se llama a WdfWmiProviderCreate. A continuación, el ejemplo inicializa una estructura de WDF_WMI_INSTANCE_CONFIG y llama a WdfWmiInstanceCreate.

WDF_WMI_PROVIDER_CONFIG  providerConfig;
WDFWMIPROVIDER  provider;
GUID  providerGuid = MY_WMI_DATA_BLOCK_GUID;
WDF_WMI_INSTANCE_CONFIG  instanceConfig;
WDFWMIINSTANCE  instanceHandle;
NTSTATUS  status;

WDF_WMI_PROVIDER_CONFIG_INIT(
                             &providerConfig,
                             providerGuid
                             );
providerConfig.Flags = WdfWmiProviderTracing;
providerConfig.EvtWmiProviderFunctionControl = MyProviderFunctionControl;

status = WdfWmiProviderCreate(
                              Device,
                              &providerConfig,
                              WDF_NO_OBJECT_ATTRIBUTES,
                              &provider
                              );

if (!NT_SUCCESS(status)) {
    return status;
}
WDF_WMI_INSTANCE_CONFIG_INIT_PROVIDER(
                                      &instanceConfig,
                                      provider
                                      );
status = WdfWmiInstanceCreate(
                              Device,
                              &instanceConfig,
                              WDF_NO_OBJECT_ATTRIBUTES,
                              &instanceHandle
                              );
if (!NT_SUCCESS(status)) {
    return status;
}