Metodo IPart::GetSubType (devicetopology.h)

  • Articolo

Il metodo GetSubType ottiene il sottotipo della parte di questa parte.

Sintassi

HRESULT GetSubType(
  [out] GUID *pSubType
);

Parametri

[out] pSubType

Puntatore a una variabile GUID in cui il metodo scrive il GUID del sottotipo per questa parte.

Valore restituito

Se il metodo ha esito positivo, viene restituito S_OK. Se ha esito negativo, i possibili codici restituiti includono, ma non sono limitati, i valori illustrati nella tabella seguente.

Codice restituito Descrizione
E_POINTER
 Pointer pSubType è NULL.

Commenti

Questo metodo recupera in genere uno dei valori GUID KSNODETYPE_Xxx dal file di intestazione Ksmedia.h, anche se alcuni driver personalizzati potrebbero fornire altri valori GUID. Per altre informazioni sui GUID KSNODETYPE_Xxx , vedere la documentazione di Windows DDK.

Come spiegato in IPart Interface, una parte può essere un connettore o una subunit.

Per una parte che è un connettore, questo metodo recupera il GUID della categoria di pin assegnato dal driver al connettore. Di seguito sono riportati esempi di GUID di categoria di pin:

  • KSNODETYPE_ANALOG_CONNECTOR, se il connettore fa parte del percorso dati da o verso un dispositivo analogico, ad esempio un microfono o altoparlanti.
  • KSNODETYPE_SPDIF_INTERFACE, se il connettore fa parte del percorso dati da o verso una porta S/PDIF.
Per altre informazioni, vedere la discussione sulla proprietà pin-category, KSPROPERTY_PIN_CATEGORY, nella documentazione di Windows DDK.

Per una parte che è una subunit, questo metodo recupera un GUID di sottotipo che indica la funzione di elaborazione del flusso eseguita dalla subunit. Ad esempio, per una subunit del controllo volume, il metodo recupera il valore GUID KSNODETYPE_VOLUME.

Nella tabella seguente sono elencati alcuni GUID di sottotipo che possono essere recuperati dal metodo GetSubType per una subunit.

GUID sottotipo Interfaccia di controllo Obbligatoria o facoltativa
KSNODETYPE_3D_EFFECTS IAudioChannelConfig Facoltativo
KSNODETYPE_AGC IAudioAutoGainControl Necessario
KSNODETYPE_DAC IAudioChannelConfig Facoltativo
KSNODETYPE_DEMUX IAudioOutputSelector Necessario
KSNODETYPE_DEV_SPECIFIC IDeviceSpecificProperty Necessario
KSNODETYPE_LOUDNESS IAudioLoudness Necessario
KSNODETYPE_MUTE IAudioMute Necessario
KSNODETYPE_MUX IAudioInputSelector Necessario
KSNODETYPE_PEAKMETER IAudioPeakMeter Necessario
KSNODETYPE_PROLOGIC_DECODER IAudioChannelConfig Facoltativo
KSNODETYPE_TONE IAudioBass

IAudioMidrange

IAudioTreble

 FacoltativoOpzioni

Facoltativo
KSNODETYPE_VOLUME IAudioChannelConfig

IAudioVolumeLevel

 OptionalRequired
 

Nella tabella precedente la colonna centrale elenca le interfacce di controllo supportate dalle sottounità del sottotipo specificato nella colonna sinistra. La colonna destra indica se il supporto della subunit per un'interfaccia di controllo è obbligatorio o facoltativo. Se è necessario il supporto, un'applicazione può basarsi su una subunit del sottotipo specificato per supportare l'interfaccia del controllo. Se il supporto è facoltativo, una subunit del sottotipo specificato può, ma non necessariamente, supportare l'interfaccia del controllo.

Le interfacce di controllo nella tabella precedente forniscono un accesso pratico alle proprietà delle sottounità. Tuttavia, alcune sottounità hanno proprietà per cui non esistono interfacce di controllo corrispondenti. Le applicazioni possono accedere a queste proprietà tramite l'interfaccia IKsControl . Per altre informazioni, vedere Uso dell'interfaccia IKsControl per accedere alle proprietà audio.

Requisiti

   
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione devicetopology.h

Vedi anche

Interfaccia IPart