AcxDeviceInitialize, fonction (acxdevice.h)

Article
02/06/2025

Le pilote client doit appeler AcxDeviceInitialize dans son rappel EVT_WDF_DRIVER_DEVICE_ADD, avant d’appeler WdfDeviceCreate.

Syntaxe

NTSTATUS AcxDeviceInitInitialize(
  PWDFDEVICE_INIT        DeviceInit,
  PACX_DEVICEINIT_CONFIG Config
);

Paramètres

DeviceInit

Pointeur vers une structure WDFDEVICE_INIT représentant l’appareil à initialiser.

Config

Pointeur vers une structure ACX_DEVICEINIT_CONFIG qui a été initialisée en appelant la fonction ACX_DEVICEINIT_CONFIG_INIT.

Valeur de retour

AcxDeviceInitInitialize retourne STATUS_SUCCESS si l’appel a réussi. Sinon, elle retourne un code d’erreur NTSTATUS.

Remarques

Exemple

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

Configuration requise pour ACX

version minimale d’ACX : 1.0

Pour plus d’informations sur les versions ACX, consultez vue d’ensemble de la version ACX.

Exigences

Exigence	Valeur
d’en-tête	acxdevice.h
IRQL	PASSIVE_LEVEL

Partager via