次の方法で共有

AcxFactoryCircuitInitAssignName 関数 (acxcircuit.h)

  • [アーティクル]

AcxFactoryCircuitInitAssignName 関数は、ACXFACTORYCIRCUIT のフレンドリ名を割り当てます。

構文

NTSTATUS AcxFactoryCircuitInitAssignName(
  PACXFACTORYCIRCUIT_INIT FactoryInit,
  PCUNICODE_STRING        FactoryName
);

パラメーター

FactoryInit

回路ファクトリの初期化に使用されるACXFACTORYCIRCUIT_INIT構造体。 これは、ACX 回線ファクトリ初期化情報を格納し、ファクトリを WDF デバイスに関連付けるために使用される不透明な構造です。

ACXFACTORYCIRCUIT_INIT構造体を初期化するには、AcxFactoryCircuitInitAllocate 関数 を使用します。

FactoryName

Factory_Microphoneなど、回線ファクトリ名を持つ Unicode 文字列。

戻り値

呼び出しが成功した場合に STATUS_SUCCESS を返します。 それ以外の場合は、適切なエラー コードが返されます。 詳細については、NTSTATUS 値 の使用に関するを参照してください。

備考

例

使用例を次に示します。

//
// 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);

ACX の要件

最小 ACX バージョン: 1.0

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

必要条件

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

関連項目

  • acxcircuit.h ヘッダー を する