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 版本概觀。

規格需求

需求 值
標頭 acxdevice.h
IRQL PASSIVE_LEVEL

另請參閱