Fungsi AcxFactoryCircuitInitAssignName (acxcircuit.h)

  • Artikel

Fungsi AcxFactoryCircuitInitAssignName menetapkan nama yang mudah diingat untuk ACXFACTORYCIRCUIT.

Sintaks

NTSTATUS AcxFactoryCircuitInitAssignName(
  PACXFACTORYCIRCUIT_INIT FactoryInit,
  PCUNICODE_STRING        FactoryName
);

Parameter

FactoryInit

Struktur ACXFACTORYCIRCUIT_INIT yang digunakan untuk inisialisasi pabrik sirkuit. Ini adalah struktur buram yang digunakan untuk menyimpan informasi inisialisasi pabrik Sirkuit ACX dan mengaitkan pabrik dengan perangkat WDF.

Gunakan fungsi AcxFactoryCircuitInitAllocate untuk menginisialisasi struktur ACXFACTORYCIRCUIT_INIT.

FactoryName

String unicode dengan nama pabrik sirkuit, seperti Factory_Microphone.

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

Contoh

Contoh penggunaan ditunjukkan di bawah ini.

//
// Factory Name.
//
DECLARE_CONST_UNICODE_STRING(s_FactoryName, L"Render");
    
    //
    // Get a FactoryCircuitInit structure.
    //
    factoryInit = AcxFactoryCircuitInitAllocate(Device);

    //
    // Add factory identifiers.
    //
    AcxFactoryCircuitInitSetComponentId(factoryInit, &KSCATEGORY_APXCIRCUITFACTORY);
    AcxFactoryCircuitInitAssignCategories(factoryInit, &KSCATEGORY_APXCIRCUITFACTORY, 1);
    AcxFactoryCircuitInitAssignName(factoryInit, &s_FactoryName);

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