Funzione AcxDeviceInitInitialize (acxdevice.h)

Articolo
02/06/2025

Il driver client deve chiamare AcxDeviceInitInitialize nel callback EVT_WDF_DRIVER_DEVICE_ADD prima di chiamare WdfDeviceCreate.

Sintassi

NTSTATUS AcxDeviceInitInitialize(
  PWDFDEVICE_INIT        DeviceInit,
  PACX_DEVICEINIT_CONFIG Config
);

Parametri

DeviceInit

Puntatore a una struttura WDFDEVICE_INIT che rappresenta il dispositivo da inizializzare.

Config

Puntatore a una struttura ACX_DEVICEINIT_CONFIG inizializzata chiamando la funzione ACX_DEVICEINIT_CONFIG_INIT.

Valore restituito

AcxDeviceInitInitialize restituisce STATUS_SUCCESS se la chiamata ha avuto esito positivo. In caso contrario, restituisce un NTSTATUS codice di errore.

Osservazioni

Esempio

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

Requisiti ACX

versione minima di ACX: 1.0

Per altre informazioni sulle versioni di ACX, vedere panoramica della versione ACX.

Fabbisogno

Requisito	Valore
intestazione	acxdevice.h
IRQL	PASSIVE_LEVEL

Condividi tramite