Metodo IPart::GetSubType (devicetopology.h)
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 |
|---|---|
|
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 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 | FacoltativoOpzioni Facoltativo |
| KSNODETYPE_VOLUME | IAudioChannelConfig | 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 |