Struttura ACMFORMATDETAILS (msacm.h)

Articolo
03/05/2024

La struttura ACMFORMATDETAILS descrive in dettaglio un formato audio waveform per un tag di formato specifico per un driver ACM.

Sintassi

typedef struct tACMFORMATDETAILS {
  DWORD          cbStruct;
  DWORD          dwFormatIndex;
  DWORD          dwFormatTag;
  DWORD          fdwSupport;
  LPWAVEFORMATEX pwfx;
  DWORD          cbwfx;
  char           szFormat[ACMFORMATDETAILS_FORMAT_CHARS];
} ACMFORMATDETAILS, *PACMFORMATDETAILS, *LPACMFORMATDETAILS;

Members

cbStruct

Dimensioni, in byte, della struttura ACMFORMATDETAILS . Questo membro deve essere inizializzato prima che un'applicazione chiami la funzione acmFormatDetails o acmFormatEnum . Le dimensioni specificate da questo membro devono essere sufficienti per contenere la struttura ACMFORMATDETAILS di base. Quando viene restituita la funzione acmFormatDetails , questo membro contiene le dimensioni effettive delle informazioni restituite. Le informazioni restituite non supereranno mai le dimensioni richieste.

dwFormatIndex

Indice del formato per cui recuperare i dettagli. L'indice varia da zero a uno minore del numero di formati standard supportati da un driver ACM per un tag di formato. Il numero di formati standard supportati da un driver per un tag di formato è contenuto nella struttura ACMFORMATTAGDETAILS . Il membro dwFormatIndex viene usato solo quando un'applicazione esegue una query di formato standard dettagli relativi a un driver per indice; in caso contrario, questo membro deve essere zero. Inoltre, questo membro verrà impostato su zero da ACM quando un'applicazione esegue una query per informazioni dettagliate su un formato; in altre parole, questo membro viene usato solo per l'input e non viene mai restituito da ACM o da un driver ACM.

dwFormatTag

Tag di formato audio waveform descritto dalla struttura ACMFORMATDETAILS . Questo membro viene usato per l'input per il flag di query ACM_FORMATDETAILSF_INDEX. Per il flag di query ACM_FORMATDETAILSF_FORMAT, questo membro deve essere inizializzato nello stesso tag di formato specificato dal membro pwfx . Se una chiamata alla funzione acmFormatDetails ha esito positivo, questo membro viene sempre restituito. Questo membro deve essere impostato su WAVE_FORMAT_UNKNOWN per tutti gli altri flag di query.

fdwSupport

Flag di supporto driver specifici del formato specificato. Questi flag sono identici alla struttura ACMDRIVERDETAILS . Questo membro può essere una combinazione dei valori seguenti e indica le operazioni supportate dal driver per il tag di formato:

Nome	Descrizione
ACMDRIVERDETAILS_SUPPORTF_ASYNC	Il driver supporta conversioni asincrone con il tag di formato specificato.
ACMDRIVERDETAILS_SUPPORTF_CODEC	Il driver supporta la conversione tra due tag di formato diversi per il formato specificato. Ad esempio, se un driver supporta la compressione da WAVE_FORMAT_PCM a WAVE_FORMAT_ADPCM con il formato specificato, questo flag viene impostato.
ACMDRIVERDETAILS_SUPPORTF_CONVERTER	Il driver supporta la conversione tra due formati diversi dello stesso tag di formato durante l'uso del formato specificato. Ad esempio, se un driver supporta il ricampionamento di WAVE_FORMAT_PCM nel formato specificato, questo flag viene impostato.
ACMDRIVERDETAILS_SUPPORTF_FILTER	Il driver supporta un filtro (che modifica i dati senza modificare alcun attributo di formato) con il formato specificato. Ad esempio, se un driver supporta operazioni di volume o echo su WAVE_FORMAT_PCM, questo flag viene impostato.
ACMDRIVERDETAILS_SUPPORTF_HARDWARE	Il driver supporta l'input hardware e/o l'output del formato specificato tramite un dispositivo audio waveform. Un'applicazione deve usare acmMetrics con gli indici delle metriche ACM_METRIC_HARDWARE_WAVE_INPUT e ACM_METRIC_HARDWARE_WAVE_OUTPUT per ottenere gli identificatori di dispositivo audio waveform associati al driver ACM di supporto.

pwfx

Puntatore a una struttura WAVEFORMATEX che riceverà i dettagli del formato. Questa struttura non richiede l'inizializzazione da parte dell'applicazione, a meno che non venga specificato il flag ACM_FORMATDETAILSF_FORMAT nella funzione acmFormatDetails . In questo caso, il membro wFormatTag della struttura WAVEFORMATEX deve essere uguale al dwFormatTag della struttura ACMFORMATDETAILS .

cbwfx

Dimensioni, in byte, disponibili per pwfx per ricevere i dettagli del formato. Le funzioni acmMetrics e acmFormatTagDetails possono essere usate per determinare le dimensioni massime necessarie per qualsiasi formato disponibile per il driver specificato (o per tutti i driver ACM installati).

szFormat[ACMFORMATDETAILS_FORMAT_CHARS]

Stringa che descrive il formato per il tipo dwFormatTag . Se la funzione acmFormatDetails ha esito positivo, questa stringa viene sempre restituita.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	msacm.h