AcxDeviceDetachCircuit 関数 (acxdevice.h)

  • [アーティクル]

AcxDeviceDetachCircuit 関数は、削除前に WDFDEVICE からオーディオ回線をデタッチします。

構文

NTSTATUS AcxDeviceDetachCircuit(
  WDFDEVICE  Device,
  ACXCIRCUIT Circuit
);

パラメーター

Device

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

Circuit

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

戻り値

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

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

AcxDeviceDetachCircuit は、デバイスから回線をデタッチします。 呼び出し元は、 ACXCIRCUIT オブジェクトを削除する必要があります。

解説

例

WDFDEVICE                    Device;
NTSTATUS                     status;
PCODEC_RENDER_DEVICE_CONTEXT renderDevCtx = NULL;

// Code to initialize WDFDEVICE...

renderDevCtx = GetRenderDeviceContext(Device);

ASSERT(renderDevCtx->Circuit);
status = AcxDeviceDetachCircuit(Device, renderDevCtx->Circuit);

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

ACX の要件

最小 ACX バージョン: 1.0

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

要件

要件 値
Header acxdevice.h
IRQL PASSIVE_LEVEL

こちらもご覧ください