Share via

EVT_ACX_FACTORY_CIRCUIT_DELETE_CIRCUITDEVICE fungsi panggilan balik (acxcircuit.h)

  • Artikel

Panggilan balik EVT_ACX_FACTORY_CIRCUIT_DELETE_CIRCUITDEVICE dipanggil oleh ACX ketika driver harus menghapus WDFDEVICE yang dibuat sebelumnya yang terkait dengan objek ACXCIRCUIT.

Sintaks

EVT_ACX_FACTORY_CIRCUIT_DELETE_CIRCUITDEVICE EvtAcxFactoryCircuitDeleteCircuitdevice;

NTSTATUS EvtAcxFactoryCircuitDeleteCircuitdevice(
  WDFDEVICE Parent,
  ACXFACTORYCIRCUIT Factory,
  WDFDEVICE Device
)
{...}

Parameter

Parent

Objek WDFDEVICE (dijelaskan dalam Ringkasan Objek Kerangka Kerja) yang merupakan induk dari WDFDEVICE yang dirujuk dalam objek Perangkat.

Factory

Pabrik sirkuit yang ada ACXFACTORYCIRCUIT Object. Untuk informasi selengkapnya tentang objek ACX, lihat Ringkasan Objek ACX.

Device

Objek WDFDEVICE (dijelaskan dalam Ringkasan Objek Kerangka Kerja) yang harus dihapus.

Menampilkan nilai

Mengembalikan STATUS_SUCCESS jika panggilan berhasil. Jika tidak, kode kesalahan akan menampilkan kode kesalahan yang sesuai. Untuk informasi selengkapnya, lihat Menggunakan Nilai NTSTATUS.

Keterangan

AcxFactoryCircuit mewakili objek pabrik yang mampu membuat ACXCIRCUIT sesuai permintaan.

Driver dapat mendaftarkan satu atau beberapa ACXFACTORYCIRCUIT dengan ACX, tindakan ini akan memberi tahu ACX bahwa driver mampu membuat ACXCIRCUITs dari jenis yang terdefinisi dengan baik.

ACX memanggil panggilan balik ACXFACTORYCIRCUIT ketika mendeteksi bahwa jalur audio memerlukan salah satu pabrik yang disediakan ACXCIRCUITs.

Ini adalah panggilan balik opsional, jika panggilan balik EVT_ACX_FACTORY_CIRCUIT_DELETE_CIRCUITDEVICE tidak ditentukan, ACX mengambil tindakan default untuk menghapus WDFDEVICE yang ditentukan dari daftar perangkat enumerasi. Tindakan ini memicu pemberitahuan PnP yang dihapus secara mendadak ke WDFDEVICE anak.

Objek ACXFACTORYCIRCUIT mendukung ACXCIRCUITs dinamis, ini berarti bahwa setiap ACXCIRCUIT yang dibuat oleh pabrik dikaitkan dengan WDFDEVICE dan kedua objek ini memiliki masa pakai yang sama.

AcxFactoryCircuit memiliki antrean WDF khusus. Untuk informasi selengkapnya tentang antrean WDF, lihat Objek Antrean Kerangka Kerja.

Persyaratan ACX

Versi ACX minimum: 1.0

Untuk informasi selengkapnya tentang versi ACX, lihat Gambaran umum versi ACX.

Persyaratan

Persyaratan Nilai
Header acxcircuit.h
IRQL PASSIVE_LEVEL

Lihat juga