Metodo IPinName::GetPinName (portcls.h)

2025-02-07

Il metodo GetPinName recupera il nome descrittivo di un endpoint audio. Per altre informazioni sui pin, vedere Proprietà filtro, pin e 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). Per altre informazioni sui runtime di integrazione, vedere IRP e pacchetti di richieste di I/O .

[in] Pin

Specifica un puntatore al pin KS (Kernel Streaming) sottostante.

[out] Data

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

Valore restituito

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

Osservazioni

Se un client necessita del nome pin corrente di un endpoint, ma ha determinato che il driver miniport non supporta il metodo GetPinName, il client usa il nome descrittivo del pin del bridge della topologia. Per altre informazioni sulle categorie di pin e sui nomi descrittivi, vedere Proprietà categoria pin e nomi descrittivi per i dispositivi endpoint audio.

Per altre informazioni su

Nota in Windows 7, lo stack audio in modalità utente non supporta la personalizzazione del nome dell'endpoint altoparlanti. Quindi in Windows 7, il metodo GetPinName 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 Altoparlanti:

KSNODETYPE_SPEAKER

KSNODETYPE_DESKTOP_SPEAKER

KSNODETYPE_ROOM_SPEAKER

KSNODETYPE_LOW_FREQUENCY_EFFECTS_SPEAKER

Fabbisogno

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.