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

Статья
02/22/2024

Драйвер клиента должен вызвать 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 .

Remarks

Пример

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

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