AcxFactoryCircuitInitAssignComponentUri, fonction (acxcircuit.h)
La fonction AcxFactoryCircuitInitAssignComponentUri attribue une chaîne d’URI en tant qu’identificateur pour ACXFACTORYCIRCUIT.
Syntaxe
NTSTATUS AcxFactoryCircuitInitAssignComponentUri(
PACXFACTORYCIRCUIT_INIT FactoryInit,
PCUNICODE_STRING ComponentUri
);
Paramètres
FactoryInit
Structure ACXFACTORYCIRCUIT_INIT utilisée pour l’initialisation d’usine de circuit. Il s’agit d’une structure opaque utilisée pour stocker les informations d’initialisation des fabriques de circuit ACX et associer la fabrique à un appareil WDF.
Utilisez la fonction AcxFactoryCircuitInitAllocate pour initialiser la structure ACXFACTORYCIRCUIT_INIT.
ComponentUri
Chaîne Unicode qui décrit le composant.
Valeur de retour
Retourne STATUS_SUCCESS si l’appel a réussi. Sinon, elle retourne un code d’erreur approprié. Pour plus d’informations, consultez Using NTSTATUS Values.
Remarques
Le pilote doit initialiser l’identité de la fabrique de circuit en définissant son URI et/ou son ID (AcxCircuitInitSetComponentId).
Exemple
L’exemple d’utilisation est illustré ci-dessous.
DECLARE_CONST_UNICODE_STRING(dspFactoryName, L"DspFactoryCircuit");
DECLARE_CONST_UNICODE_STRING(dspFactoryUri, L"URI_Goes_Here");
//
// Get a FactoryCircuitInit structure.
//
PACXFACTORYCIRCUIT_INIT factoryInit = NULL;
factoryInit = AcxFactoryCircuitInitAllocate(Device);
//
// Add factory identifiers.
//
status = cxFactoryCircuitInitAssignComponentUri(factoryInit, &dspFactoryUri);
status = AcxFactoryCircuitInitAssignName(factoryInit, &dspFactoryName);
Configuration requise pour ACX
version minimale d’ACX : 1.0
Pour plus d’informations sur les versions ACX, consultez vue d’ensemble de la version ACX.
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | acxcircuit.h |
| IRQL | PASSIVE_LEVEL |