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

Artigo
08/07/2023

O GetPinName método recupera o nome amigável de um ponto de extremidade de áudio. Para obter mais informações sobre pins, consulte Propriedades de filtro, fixação e nó.

Sintaxe

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

Parâmetros

[in] Irp

Especifica um ponteiro para uma estrutura de IRP (pacote de solicitação de E/S). Para obter mais informações sobre IRPs, consulte Pacotes de solicitação de E/S e IRP.

[in] Pin

Especifica um ponteiro para o pino de KS (streaming de kernel) subjacente.

[out] Data

Especifica um ponteiro para o buffer que contém os dados do GetPinName método .

Retornar valor

O GetPinName método retornará STATUS_SUCCESS se a chamada tiver sido bem-sucedida. Caso contrário, ele retornará um código de erro apropriado.

Comentários

Se um cliente precisar do nome do pino atual de um ponto de extremidade, mas tiver determinado que o driver de miniporto não dá suporte ao GetPinName método , o cliente usará o nome amigável do pino da ponte de topologia. Para obter mais informações sobre categorias de pin e nomes amigáveis, consulte Fixar propriedade de categoria e nomes amigáveis para dispositivos de ponto de extremidade de áudio.

Para saber mais sobre

Nota No Windows 7, a pilha de áudio no modo de usuário não dá suporte à personalização do nome do ponto de extremidade alto-falantes. Portanto, no Windows 7, o GetPinName método só funciona com pontos de extremidade que não têm o nome amigável dos alto-falantes. A lista a seguir mostra as categorias de tipo de nó KS que recebem o nome amigável dos alto-falantes:

KSNODETYPE_SPEAKER

KSNODETYPE_DESKTOP_SPEAKER

KSNODETYPE_ROOM_SPEAKER

KSNODETYPE_LOW_FREQUENCY_EFFECTS_SPEAKER

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível no Windows 7 e versões posteriores do Windows.
Plataforma de Destino	Universal
Cabeçalho	portcls.h (inclua Portcls.h)
IRQL	PASSIVE_LEVEL.