Funzione AcxCircuitInitAssignCategories (acxcircuit.h)
La funzione AcxCircuitInitAssignCategories assegna un set di voci KSCATERGORY per ACXCIRCUIT.
Sintassi
NTSTATUS AcxCircuitInitAssignCategories(
PACXCIRCUIT_INIT CircuitInit,
const GUID *Categories,
ULONG CategoriesCount
);
Parametri
CircuitInit
Struttura ACXCIRCUIT_INIT che definisce l'inizializzazione del circuito. ACXCIRCUIT_INIT è un oggetto opaco usato per l'inizializzazione del circuito. Usare AcxCircuitInitAllocate per inizializzare la struttura di ACXCIRCUIT_INIT.
Categories
Matrice che contiene GUIDS della KSCATERGORY desiderata, ad esempio KSCATEGORY_AUDIO. Per altre informazioni sulle voci KSCATERGORY, vedere Installazione di interfacce dispositivo per un adattatore audio.
CategoriesCount
Numero di categorie che verranno aggiunte al circuito. Si tratta di un conteggio basato.
Valore restituito
Restituisce STATUS_SUCCESS se la chiamata ha avuto esito positivo. In caso contrario, restituisce un codice di errore appropriato. Per altre informazioni, vedere Uso dei valori NTSTATUS.
Commenti
Questa chiamata esegue l'override del set di categorie predefinito inizializzato da ACX, basato sul tipo ACXCIRCUIT.
Esempio
Di seguito è riportato l'esempio di utilizzo.
GUID captureCategories[] =
{
STATICGUIDOF(KSCATEGORY_AUDIO),
STATICGUIDOF(KSCATEGORY_CAPTURE),
STATICGUIDOF(KSCATEGORY_REALTIME),
STATICGUIDOF(KSCATEGORY_TOPOLOGY),
};
//
// Add circuit identifiers.
//
AcxCircuitInitSetComponentId(CircuitInit, &COMPONENT_GUID);
AcxCircuitInitAssignName(CircuitInit, &circuitName);
status = AcxCircuitInitAssignCategories(CircuitInit, captureCategories, SIZEOF_ARRAY(captureCategories));
Requisiti ACX
Versione minima DI ACX: 1.0
Per altre informazioni sulle versioni ACX, vedere Panoramica della versione di ACX.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione | acxcircuit.h |
| IRQL | PASSIVE_LEVEL |