Funzione AcxDeviceRemoveCircuitDevice (acxdevice.h)
La funzione AcxDeviceRemoveCircuitDevice rimuove un dispositivo circuito ACX da un dispositivo padre specificato.
Sintassi
NTSTATUS AcxDeviceRemoveCircuitDevice(
WDFDEVICE ParentDevice,
WDFDEVICE Device
);
Parametri
ParentDevice
L'WDFDEVICE padre da cui rimuovere il dispositivo del circuito ACX.
Device
Il 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 NTSTATUS codice di errore.
Osservazioni
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 della serializzazione della rimozione del dispositivo e dei circuiti associati, in relazione ad altre attività Plug and Play nei dispositivi padre e di pari livello.
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 di ACX, vedere panoramica della versione ACX.
Fabbisogno
| Requisito | Valore |
|---|---|
| intestazione | acxdevice.h |
| IRQL | PASSIVE_LEVEL |