Método IPinName::GetPinName (portcls.h)

Artículo
02/26/2024

El GetPinName método recupera el nombre descriptivo de un punto de conexión de audio. Para obtener más información sobre las patillas, vea Propiedades de filtro, pin y nodo.

Sintaxis

NTSTATUS GetPinName(
  [in]  PIRP     Irp,
  [in]  PKSP_PIN Pin,
  [out] PVOID    Data
);

Parámetros

[in] Irp

Especifica un puntero a una estructura de paquetes de solicitud de E/S (IRP). Para obtener más información sobre los IRP, consulte Paquetes de solicitud de E/S e IRP.

[in] Pin

Especifica un puntero a la patilla de streaming del kernel subyacente (KS).

[out] Data

Especifica un puntero al búfer que contiene los datos del GetPinName método .

Valor devuelto

El GetPinName método devuelve STATUS_SUCCESS si la llamada se realizó correctamente. De lo contrario, devuelve un código de error adecuado.

Comentarios

Si un cliente necesita el nombre de anclaje actual de un punto de conexión, pero ha determinado que el controlador de minipuerto no admite el GetPinName método , el cliente usa el nombre descriptivo del pin del puente de topología. Para obtener más información sobre las categorías de patillas y los nombres descriptivos, vea Anclar propiedades de categoría y nombres descriptivos para dispositivos de punto de conexión de audio.

Para más información sobre

Nota En Windows 7, la pila de audio en modo de usuario no admite la personalización del nombre del punto de conexión de altavoces. Por lo tanto, en Windows 7, el GetPinName método solo funciona con puntos de conexión que no tienen el nombre descriptivo de oradores. En la lista siguiente se muestran las categorías de tipo de nodo KS a las que se les asigna el nombre descriptivo de oradores:

KSNODETYPE_SPEAKER

KSNODETYPE_DESKTOP_SPEAKER

KSNODETYPE_ROOM_SPEAKER

KSNODETYPE_LOW_FREQUENCY_EFFECTS_SPEAKER

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Windows 7 y versiones posteriores de Windows.
Plataforma de destino	Universal
Encabezado	portcls.h (incluir Portcls.h)
IRQL	PASSIVE_LEVEL.