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

  • Artigo

O retorno de chamada EVT_ACX_CIRCUIT_COMPOSITE_INITIALIZE é usado pelo driver para fazer qualquer pós-inicialização após o ponto de extremidade composto ter sido montado pelo Gerenciador ACX.

Sintaxe

EVT_ACX_CIRCUIT_COMPOSITE_INITIALIZE EvtAcxCircuitCompositeInitialize;

NTSTATUS EvtAcxCircuitCompositeInitialize(
  WDFDEVICE Device,
  ACXCIRCUIT Circuit,
  ACXOBJECTBAG CompositeProperties
)
{...}

Parâmetros

Device

Um objeto WDFDEVICE (descrito em Resumo de Objetos de Estrutura) 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.

CompositeProperties

Identificador opcional para CompositeProperties que descreve o circuito composto. Este é um objeto ACXOBJECTBAG opcional para as propriedades do ponto de extremidade composto.

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 composta do recipiente de objetos de propriedade composta especificado.

EVT_ACX_CIRCUIT_COMPOSITE_INITIALIZE CodecR_EvtCircuitCompositeInitialize;

NTSTATUS
CodecR_EvtCircuitCompositeInitialize(
    _In_ WDFDEVICE      Device,
    _In_ ACXCIRCUIT     Circuit,
    _In_ ACXOBJECTBAG   CompositeProperties
    )
{
    PAGED_CODE();

    NTSTATUS status = STATUS_SUCCESS;

    UNREFERENCED_PARAMETER(Device);
    UNREFERENCED_PARAMETER(Circuit);

    ASSERT(CompositeProperties);

    DECLARE_CONST_ACXOBJECTBAG_SYSTEM_PROPERTY_NAME(UniqueID);
    GUID uniqueId = {0};
    status = AcxObjectBagRetrieveGuid(CompositeProperties, &UniqueID, &uniqueId);

    // ...

    return status;
}

Requisitos do ACX

Versão mínima do ACX: 1.0

Para obter mais informações sobre 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