Método IPart::GetSubType (devicetopology.h)

  • Artículo

El método GetSubType obtiene el subtipo de parte de esta parte.

Sintaxis

HRESULT GetSubType(
  [out] GUID *pSubType
);

Parámetros

[out] pSubType

Puntero a una variable GUID en la que el método escribe el GUID de subtipo para esta parte.

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK. Si se produce un error, los posibles códigos de retorno incluyen, pero no están limitados a, los valores que se muestran en la tabla siguiente.

Código devuelto Descripción
E_POINTER
 El puntero pSubType es NULL.

Comentarios

Este método normalmente recupera uno de los valores guid de KSNODETYPE_Xxx del archivo de encabezado Ksmedia.h, aunque algunos controladores personalizados podrían proporcionar otros valores GUID. Para obtener más información sobre KSNODETYPE_Xxx GUID, consulte la documentación de DDK de Windows.

Como se explica en IPart Interface, una parte puede ser un conector o una subunidad.

Para una parte que es un conector, este método recupera el GUID de categoría de anclaje que el controlador ha asignado al conector. A continuación se muestran ejemplos de GUID de categoría de pin:

  • KSNODETYPE_ANALOG_CONNECTOR, si el conector forma parte de la ruta de acceso de datos hacia o desde un dispositivo analógico, como un micrófono o altavoces.
  • KSNODETYPE_SPDIF_INTERFACE, si el conector forma parte de la ruta de acceso de datos hacia o desde un puerto S/PDIF.
Para obtener más información, vea la explicación de la propiedad pin-category, KSPROPERTY_PIN_CATEGORY, en la documentación de DDK de Windows.

Para una parte que es una subunidad, este método recupera un GUID de subtipo que indica la función de procesamiento de secuencias que realiza la subunidad. Por ejemplo, para una subunidad de control de volumen, el método recupera el valor GUID KSNODETYPE_VOLUME.

En la tabla siguiente se enumeran algunos de los GUID de subtipo que el método GetSubType puede recuperar para una subunidad.

GUID de subtipo Interfaz de control Obligatorio u opcional
KSNODETYPE_3D_EFFECTS IAudioChannelConfig Opcionales
KSNODETYPE_AGC IAudioAutoGainControl Requerido
KSNODETYPE_DAC IAudioChannelConfig Opcionales
KSNODETYPE_DEMUX IAudioOutputSelector Requerido
KSNODETYPE_DEV_SPECIFIC IDeviceSpecificProperty Requerido
KSNODETYPE_LOUDNESS IAudioLoudness Requerido
KSNODETYPE_MUTE IAudioMute Requerido
KSNODETYPE_MUX IAudioInputSelector Requerido
KSNODETYPE_PEAKMETER IAudioPeakMeter Requerido
KSNODETYPE_PROLOGIC_DECODER IAudioChannelConfig Opcionales
KSNODETYPE_TONE IAudioBass

IAudioMidrange

IAudioTreble

 OptionalOptional

Opcionales
KSNODETYPE_VOLUME IAudioChannelConfig

IAudioVolumeLevel

 OptionalRequired
 

En la tabla anterior, la columna central enumera las interfaces de control admitidas por las subunits del subtipo especificado en la columna izquierda. La columna derecha indica si la compatibilidad de la subbúnit con una interfaz de control es necesaria o opcional. Si se requiere compatibilidad, una aplicación puede confiar en una subunidad del subtipo especificado para admitir la interfaz de control. Si la compatibilidad es opcional, una subunidad del subtipo especificado puede, pero no necesariamente, admite la interfaz de control.

Las interfaces de control de la tabla anterior proporcionan acceso práctico a las propiedades de las subunits. Sin embargo, algunas subunits tienen propiedades para las que no existen interfaces de control correspondientes. Las aplicaciones pueden acceder a estas propiedades a través de la interfaz IKsControl . Para obtener más información, vea Usar la interfaz IKsControl para acceder a las propiedades de audio.

Requisitos

   
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado devicetopology.h

Consulte también

IPart (interfaz)