Compartilhar via

função de retorno de chamada EVT_ACX_CIRCUIT_COMPOSITE_CIRCUIT_INITIALIZE (acxcircuit.h)

  • Artigo

O retorno de chamada EVT_ACX_CIRCUIT_COMPOSITE_CIRCUIT_INITIALIZE é usado pelo driver para fazer qualquer inicialização de um circuito composto quando ele é detectado e inicializado pelo ACX Manager.

Sintaxe

EVT_ACX_CIRCUIT_COMPOSITE_CIRCUIT_INITIALIZE EvtAcxCircuitCompositeCircuitInitialize;

NTSTATUS EvtAcxCircuitCompositeCircuitInitialize(
  WDFDEVICE Device,
  ACXCIRCUIT Circuit,
  ACXOBJECTBAG CircuitProperties
)
{...}

Parâmetros

Device

Um objeto WDFDEVICE (descrito em Resumo de Objetos framework) associado ao ACXCIRCUIT especificado.

Circuit

O objeto ACXCIRCUIT que está sendo inicializado. Para obter mais informações sobre objetos ACX, consulte Resumo de objetos ACX.

CircuitProperties

Identificador opcional para CircuitProperties. Esse é um objeto ACXOBJECTBAG opcional para as propriedades de ACXCIRCUIT.

Retornar valor

Retorna STATUS_SUCCESS se a chamada foi bem-sucedida. Caso contrário, ele retornará um código de erro apropriado. Para obter mais informações, consulte Usando valores NTSTATUS.

Comentários

Exemplo

Este código de exemplo mostra como o driver recupera uma propriedade de circuito do recipiente de objetos de propriedade de circuito especificado.

DspR_EvtCircuitCompositeCircuitInitialize(
    _In_     WDFDEVICE      Device,
    _In_     ACXCIRCUIT     Circuit,
    _In_opt_ ACXOBJECTBAG   CircuitProperties
    )
{
    NTSTATUS status = STATUS_SUCCESS;

    PAGED_CODE();
    
    UNREFERENCED_PARAMETER(Device);
    UNREFERENCED_PARAMETER(Circuit);

    if (CircuitProperties != NULL)
    {
        DECLARE_CONST_ACXOBJECTBAG_DRIVER_PROPERTY_NAME(msft, TestUI4);
        ULONG testUI4;

        status = AcxObjectBagRetrieveUI4(CircuitProperties, &TestUI4, &testUI4);
        if (!NT_SUCCESS(status))
        {
            // Log error.
            goto exit;
        }

        //...
    }
    
    //...

    // All done.
    status = STATUS_SUCCESS;

exit:
    return status;
}

Requisitos do ACX

Versão mínima do ACX: 1.0

Para obter mais informações sobre as versões do ACX, consulte Visão geral da versão do ACX.

Requisitos

Requisito Valor
Cabeçalho acxcircuit.h
IRQL PASSIVE_LEVEL

Confira também