次の方法で共有

AcxDeviceRemoveFactoryCircuit 関数 (acxdevice.h)

  • [アーティクル]

AcxDeviceRemoveFactoryCircuit 関数は、WDFDEVICEからオーディオ回線を作成するためのファクトリ回線を削除します。

構文

NTSTATUS AcxDeviceRemoveFactoryCircuit(
  WDFDEVICE         Device,
  ACXFACTORYCIRCUIT Factory
);

パラメーター

Device

ACX ファクトリ回線の削除元となる WDFDEVICE。

Factory

Device パラメーターで指定された、WDFDEVICE から削除する ACX ファクトリ回線。

戻り値

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

備考

一般的なドライバーは、AcxDeviceRemoveFactoryCircuit呼び出す必要はありません。 ファクトリ回線でまだアクティブな回線デバイスが作成されている場合は、この関数を呼び出さないでください。

ドライバーがファクトリ回線に対してこの関数を呼び出すことにした場合、AcxDeviceRemoveFactoryCircuit が呼び出される前に、関連付けられているファクトリ回線を介して作成された回線デバイス最初に削除する必要があります。

回線の操作の詳細については、ACX 回線の動的除去 および ACX デバイス列挙を参照してください。

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

AcxDeviceAddFactoryCircuit を使用して、WDFDEVICEにファクトリ回線を追加します。

ACX の要件

最小 ACX バージョン: 1.0

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

必要条件

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

関連項目