Função AcxDeviceInitInitialize (acxdevice.h)

Artigo
02/06/2025

O driver cliente deve chamar AcxDeviceInitInitialize em seu retorno de chamada EVT_WDF_DRIVER_DEVICE_ADD, antes de chamar WdfDeviceCreate.

Sintaxe

NTSTATUS AcxDeviceInitInitialize(
  PWDFDEVICE_INIT        DeviceInit,
  PACX_DEVICEINIT_CONFIG Config
);

Parâmetros

DeviceInit

Ponteiro para uma estrutura WDFDEVICE_INIT que representa o dispositivo a ser inicializado.

Config

Ponteiro para uma estrutura de ACX_DEVICEINIT_CONFIG que foi inicializada chamando a função ACX_DEVICEINIT_CONFIG_INIT.

Valor de retorno

AcxDeviceInitInitialize retornará STATUS_SUCCESS se a chamada tiver sido bem-sucedida. Caso contrário, ele retornará um código de erro NTSTATUS.

Observações

Exemplo

WDFDEVICE             Parent;
NTSTATUS              status;
PWDFDEVICE_INIT       devInit = NULL;
ACX_DEVICEINIT_CONFIG devInitCfg;

// Code to initialize WDFDEVICE...

//
// Create a child audio device for this circuit.
//
devInit = WdfPdoInitAllocate(Parent);

if (NULL == devInit) 
{
    status = STATUS_INSUFFICIENT_RESOURCES;
    ASSERT(FALSE);
    goto exit;
}

//
// Allow ACX to add any pre-requirement it needs on this device.
//
ACX_DEVICEINIT_CONFIG_INIT(&devInitCfg);

devInitCfg.Flags |= AcxDeviceInitConfigRawDevice; 

status = AcxDeviceInitInitialize(devInit, &devInitCfg);

if (!NT_SUCCESS(status)) 
{
    ASSERT(FALSE);
    goto exit;
}

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	acxdevice.h
IRQL	PASSIVE_LEVEL

Partilhar via