Condividi tramite

Funzione AcxDeviceRemoveCircuitDevice (acxdevice.h)

  • Articolo

La funzione AcxDeviceRemoveCircuitDevice rimuove un dispositivo circuito ACX da un dispositivo padre specificato.

Sintassi

NTSTATUS AcxDeviceRemoveCircuitDevice(
  WDFDEVICE ParentDevice,
  WDFDEVICE Device
);

Parametri

ParentDevice

WDFDEVICE padre da cui rimuovere il dispositivo circuito ACX.

Device

WDFDEVICE che rappresenta il dispositivo del circuito da rimuovere dal dispositivo padre.

Valore restituito

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

Commenti

I driver audio usano questa funzione per rimuovere un endpoint audio esistente.

Questa funzione può essere chiamata in qualsiasi momento durante il ciclo di vita del driver. Plug and Play si occupa di serializzare la rimozione del dispositivo e i circuiti associati, in relazione ad altre attività di Plug and Play nei dispositivi padre e fratelli.

Esempio

NTSTATUS status;
WDFDEVICE Device;
WDFDEVICE child;

// Code to initialize WDFDEVICE objects...

// Remove the child device.
status = AcxDeviceRemoveCircuitDevice(Device, child);

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

Requisiti ACX

Versione minima DI ACX: 1.0

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

Requisiti

Requisito Valore
Intestazione acxdevice.h
IRQL PASSIVE_LEVEL

Vedi anche