AcxDeviceAddCircuitDevice 函式 (acxdevice.h)

  • 發行項

AcxDeviceAddCircuitDevice 函式會將 ACX 線路裝置新增至代表音訊路徑的指定父裝置。

語法

NTSTATUS AcxDeviceAddCircuitDevice(
  WDFDEVICE ParentDevice,
  WDFDEVICE Device
);

參數

ParentDevice

WDFDEVICE，代表將新增線路裝置的父系。

Device

WDFDEVICE，代表要新增至父裝置的線路裝置。

傳回值

AcxDeviceAddCircuitDevice 如果呼叫成功，則會傳回STATUS_SUCCESS。 否則，它會傳回 NTSTATUS 錯誤碼。

備註

音訊驅動程式會使用此函式來列舉新的音訊端點。

此函式可以隨時在驅動程式的生命週期中呼叫。 隨插即用 會串行化裝置的列舉，以及與父系和同層級裝置上其他 隨插即用 活動相關的線路。

範例

WDFDEVICE Device;
WDFDEVICE renderDevice = NULL;
NTSTATUS  status;

// Code to initialize the WDFDEVICE...

// Code to create the WDFDEVICE renderDevice...

//
// Add circuit to device's dynamic circuit device list.
//
status = AcxDeviceAddCircuitDevice(Device, renderDevice);
if (!NT_SUCCESS(status)) 
{
    ASSERT(FALSE);
    goto exit;
}

ACX 需求

最低 ACX 版本： 1.0

如需 ACX 版本的詳細資訊，請參閱 ACX 版本概觀。

規格需求

需求 值
標頭 acxdevice.h
IRQL PASSIVE_LEVEL

另請參閱