Metodo IPinName::GetPinName (portcls.h)

Articolo
03/08/2023

Il GetPinName metodo recupera il nome descrittivo di un endpoint audio. Per altre informazioni sui pin, vedere Filtrare, aggiungere e properties del nodo.

Sintassi

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

Parametri

[in] Irp

Specifica un puntatore a una struttura IRP (Request Packet) di I/O. Per altre informazioni sui provider di integrazione, vedere Pacchetti di richieste IRP e I/O.

[in] Pin

Specifica un puntatore al pin del kernel streaming (KS) sottostante.

[out] Data

Specifica un puntatore al buffer che contiene i dati per il GetPinName metodo .

Valore restituito

Il GetPinName metodo restituisce STATUS_SUCCESS se la chiamata ha avuto esito positivo. In caso contrario, restituisce un codice di errore appropriato.

Commenti

Se un client necessita del nome pin corrente di un endpoint, ma ha determinato che il driver miniport non supporta il GetPinName metodo , il client usa il nome descrittivo del pin del bridge di topologia. Per altre informazioni sulle categorie di pin e sui nomi descrittivi, vedere Pin Category Property e Friendly Names for Audio Endpoint Devices.For more information about pin categories and friendly names, see Pin Category Property and Friendly Names for Audio Endpoint Devices.For more information about pin categories and friendly names for Audio Endpoint Devices.

Per altre informazioni su

Nota In Windows 7, lo stack audio in modalità utente non supporta la personalizzazione del nome dell'endpoint Speakers. Quindi in Windows 7, il GetPinName metodo funziona solo con gli endpoint che non hanno il nome descrittivo Altoparlanti. L'elenco seguente mostra le categorie di tipi di nodo KS assegnate al nome descrittivo Relatori:

KSNODETYPE_SPEAKER

KSNODETYPE_DESKTOP_SPEAKER

KSNODETYPE_ROOM_SPEAKER

KSNODETYPE_LOW_FREQUENCY_EFFECTS_SPEAKER

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows 7 e versioni successive di Windows.
Piattaforma di destinazione	Universale
Intestazione	portcls.h (include Portcls.h)
IRQL	PASSIVE_LEVEL.