struttura SYSAUDIO_INSTANCE_INFO (ksmedia.h)

Articolo
08/07/2023

La struttura SYSAUDIO_INSTANCE_INFO specifica il dispositivo audio virtuale da aprire e include i flag per la configurazione del dispositivo.

Sintassi

typedef struct {
  KSPROPERTY Property;
  ULONG      Flags;
  ULONG      DeviceNumber;
} SYSAUDIO_INSTANCE_INFO, *PSYSAUDIO_INSTANCE_INFO;

Members

Property

Specifica la proprietà . Questo parametro è una struttura di tipo KSPROPERTY.

Flags

Flag che specificano come configurare il dispositivo audio virtuale. Attualmente, l'unico bit di flag definito per questo parametro è SYSAUDIO_FLAGS_DONT_COMBINE_PINS. Se impostato, questo flag bit indica a SysAudio di non combinare i pin di rendering. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.

DeviceNumber

Specifica l'ID dispositivo. Questo membro identifica il dispositivo audio virtuale che deve essere aperto dalla richiesta di proprietà. Se SysAudio enumera N dispositivi audio virtuali (vedere KSPROPERTY_SYSAUDIO_DEVICE_COUNT), gli ID dispositivo validi vanno da 0 a N-1.

Commenti

Questa struttura viene utilizzata dalla proprietà KSPROPERTY_SYSAUDIO_INSTANCE_INFO .

Per impostazione predefinita, un dispositivo audio virtuale combina i relativi pin di rendering d'onda. Il flag SYSAUDIO_FLAGS_DONT_COMBINE_PINS esegue l'override di questo valore predefinito.

Quando i pin vengono combinati, il dispositivo audio virtuale espone una singola factory di pin che combina i pin di rendering con accelerazione hardware nel dispositivo audio con pin mixer emulati dal software nel driver di sistema KMixer. Se i pin non vengono combinati, i pin con accelerazione hardware e i pin emulati dal software vengono esposti tramite pin factory separate. Per segnalare correttamente il numero di pin con accelerazione hardware ai programmi dell'applicazione, DirectSound richiede che i pin non vengano combinati.

Questa proprietà è simile a KSPROPERTY_SYSAUDIO_DEVICE_INSTANCE, con l'eccezione che include i flag che specificano come configurare il dispositivo audio virtuale.