次の方法で共有

AcxDeviceRemoveCircuit 関数 (acxdevice.h)

  • [アーティクル]

AcxDeviceRemoveCircuit 関数は、指定されたオーディオ回線を ACX デバイスから削除します。

構文

NTSTATUS AcxDeviceRemoveCircuit(
  WDFDEVICE  Device,
  ACXCIRCUIT Circuit
);

パラメーター

Device

Circuit パラメーターで指定されたオーディオ回線を削除する WDFDEVICE。

Circuit

Device パラメーターで指定された WDFDEVICE から削除するオーディオ回線。

戻り値

AcxDeviceRemoveCircuit は、呼び出しが成功した場合にSTATUS_SUCCESSを返します。 それ以外の場合は、NTSTATUS エラー コードが返されます。

備考

AcxDeviceAddCircuit を使用して、WDFDEVICEにオーディオ回線を追加します。

この関数は、このデバイスの EVT_WDF_DEVICE_RELEASE_HARDWARE コールバック関数からのみ呼び出すことができます。

例

NTSTATUS              status;
WDFDEVICE             Device = NULL;
PUSBA2_DEVICE_CONTEXT devCtx;

// Code to initialize WDFDEVICE...

devCtx = GetDeviceContext(Device);

//
// Unregister filter and delete this audio filter.
//
if (devCtx->RenderCircuitAdded) {
    ASSERT(devCtx->RenderCircuit);
    status = AcxDeviceRemoveCircuit(Device, devCtx->RenderCircuit);

    devCtx->RenderCircuit = NULL;
    devCtx->RenderCircuitAdded = FALSE;
}

ACX の要件

最小 ACX バージョン: 1.0

ACX バージョンの詳細については、ACX バージョンの概要 参照してください。

必要条件

要件 価値
ヘッダー acxdevice.h
IRQL PASSIVE_LEVEL

関連項目