Struttura ACMDRIVERDETAILS (msacm.h)
La struttura ACMDRIVERDETAILS descrive le funzionalità di un driver ACM.
Sintassi
typedef struct tACMDRIVERDETAILS {
DWORD cbStruct;
FOURCC fccType;
FOURCC fccComp;
WORD wMid;
WORD wPid;
DWORD vdwACM;
DWORD vdwDriver;
DWORD fdwSupport;
DWORD cFormatTags;
DWORD cFilterTags;
HICON hicon;
char szShortName[ACMDRIVERDETAILS_SHORTNAME_CHARS];
char szLongName[ACMDRIVERDETAILS_LONGNAME_CHARS];
char szCopyright[ACMDRIVERDETAILS_COPYRIGHT_CHARS];
char szLicensing[ACMDRIVERDETAILS_LICENSING_CHARS];
char szFeatures[ACMDRIVERDETAILS_FEATURES_CHARS];
} ACMDRIVERDETAILS, *PACMDRIVERDETAILS, *LPACMDRIVERDETAILS;
Members
cbStruct
Dimensioni, in byte, delle informazioni valide contenute nella struttura ACMDRIVERDETAILS . Un'applicazione deve inizializzare questo membro alle dimensioni, in byte, delle informazioni desiderate. Le dimensioni specificate in questo membro devono essere sufficienti per contenere il membro cbStruct della struttura ACMDRIVERDETAILS . Quando la funzione acmDriverDetails restituisce , questo membro contiene le dimensioni effettive delle informazioni restituite. Le informazioni restituite non superano mai le dimensioni richieste.
fccType
Tipo del driver. Per i driver ACM, impostare questo membro su ACMDRIVERDETAILS_FCCTYPE_AUDIOCODEC.
fccComp
Sottotipo del driver. Questo membro è attualmente impostato su ACMDRIVERDETAILS_FCCCOMP_UNDEFINED (zero).
wMid
Identificatore produttore. Gli identificatori del produttore sono definiti in Identificatori produttore e prodotto.
wPid
Identificatore prodotto. Gli identificatori del prodotto sono definiti in Identificatori di prodotto e produttore.
vdwACM
Versione dell'ACM per cui è stato compilato questo driver. Il numero di versione è un numero esadecimale nel formato 0xAABBCCCC, dove AA è il numero di versione principale, BB è il numero di versione secondario e CCCC è il numero di compilazione. Le parti della versione (principali, secondarie e build) devono essere visualizzate come numeri decimali.
vdwDriver
Versione del driver. Il numero di versione è un numero esadecimale nel formato 0xAABBCCCC, dove AA è il numero di versione principale, BB è il numero di versione secondario e CCCC è il numero di compilazione. Le parti della versione (principali, secondarie e build) devono essere visualizzate come numeri decimali.
fdwSupport
Flag di supporto per il driver. I valori seguenti sono definiti:
| Nome | Descrizione |
|---|---|
|
Il driver supporta le conversioni asincrone. |
|
Il driver supporta la conversione tra due tag di formato diversi. Ad esempio, se un driver supporta la compressione da WAVE_FORMAT_PCM a WAVE_FORMAT_ADPCM, questo flag viene impostato. |
|
Il driver supporta la conversione tra due formati diversi dello stesso tag di formato. Ad esempio, se un driver supporta il ricampionamento di WAVE_FORMAT_PCM, questo flag viene impostato. |
|
Il driver è stato disabilitato. Questo flag viene impostato da ACM per un driver quando è stato disabilitato per qualsiasi motivo. I driver disabilitati non possono essere aperti e possono essere usati solo in circostanze molto limitate. |
|
Driver supporta un filtro (modifica dei dati senza modificare uno degli attributi di formato). Ad esempio, se un driver supporta operazioni di volume o echo su WAVE_FORMAT_PCM, questo flag viene impostato. |
|
Il driver supporta input hardware, output o entrambi tramite un dispositivo waveform-audio. Un'applicazione deve usare la funzione acmMetrics con gli indici delle metriche ACM_METRIC_HARDWARE_WAVE_INPUT e ACM_METRIC_HARDWARE_WAVE_OUTPUT per ottenere gli identificatori di dispositivo waveform-audio associati al driver ACM di supporto. |
|
Il driver è stato installato in locale rispetto all'attività corrente. |
cFormatTags
Numero di tag di formato univoci supportati da questo driver.
cFilterTags
Numero di tag di filtro univoci supportati da questo driver.
hicon
Gestire un'icona personalizzata per questo driver. Un'applicazione può usare questa icona per fare riferimento visivo al driver. Questo membro può essere NULL.
szShortName[ACMDRIVERDETAILS_SHORTNAME_CHARS]
Stringa con terminazione Null che descrive il nome del driver. Questa stringa deve essere visualizzata in spazi piccoli.
szLongName[ACMDRIVERDETAILS_LONGNAME_CHARS]
Stringa con terminazione null che descrive il nome completo del driver. Questa stringa deve essere visualizzata in spazi di grandi dimensioni (descrittivi).
szCopyright[ACMDRIVERDETAILS_COPYRIGHT_CHARS]
Stringa con terminazione null che fornisce informazioni sul copyright per il driver.
szLicensing[ACMDRIVERDETAILS_LICENSING_CHARS]
Stringa con terminazione null che fornisce informazioni speciali sulle licenze per il driver.
szFeatures[ACMDRIVERDETAILS_FEATURES_CHARS]
Stringa con terminazione Null che fornisce informazioni speciali sulle funzionalità per il driver.
Requisiti
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Intestazione | msacm.h |