Функция AcxDeviceInitInitialize (acxdevice.h)

Статья
02/06/2025

Драйвер клиента должен вызывать AcxDeviceInitInitialize в обратном вызове EVT_WDF_DRIVER_DEVICE_ADD, прежде чем вызывать WdfDeviceCreate.

Синтаксис

NTSTATUS AcxDeviceInitInitialize(
  PWDFDEVICE_INIT        DeviceInit,
  PACX_DEVICEINIT_CONFIG Config
);

Параметры

DeviceInit

Указатель на структуру WDFDEVICE_INIT, представляющую устройство для инициализации.

Config

Указатель на структуру ACX_DEVICEINIT_CONFIG, которая была инициализирована путем вызова функции ACX_DEVICEINIT_CONFIG_INIT.

Возвращаемое значение

AcxDeviceInitinitialize возвращает STATUS_SUCCESS, если вызов выполнен успешно. В противном случае возвращается код ошибки NTSTATUS.

Замечания

Пример

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;
}

Требования к ACX

минимальная версия ACX: 1.0

Дополнительные сведения о версиях ACX см. в обзоре версий ACX.

Требования

Требование	Ценность
заголовка	acxdevice.h
IRQL	PASSIVE_LEVEL

Поделиться через