Fungsi AcxFactoryCircuitInitAssignName (acxcircuit.h)

Penting

Beberapa informasi berkaitan dengan produk prarilis yang mungkin dimodifikasi secara substansial sebelum dirilis secara komersial. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

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.

Mengembalikan nilai

Mengembalikan STATUS_SUCCESS jika panggilan berhasil. Jika tidak, ia mengembalikan 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

   
Header acxcircuit.h

Lihat juga