GetPinName method retrieves the friendly name of an audio endpoint.
NTSTATUS GetPinName( PIRP Irp, PKSP_PIN Pin, PVOID Data );
Specifies a pointer to an I/O request packet (IRP) structure.
Specifies a pointer to the underlying kernel streaming (KS) pin.
Specifies a pointer to the buffer that holds the data for the
GetPinName method returns STATUS_SUCCESS if the call was successful. Otherwise, it returns an appropriate error code.
If a client needs the current pin name of an endpoint, but has determined that the miniport driver does not support the
GetPinName method, the client uses the friendly name of the topology bridge pin. For more information about pin categories and friendly names, see Pin Category Property and Friendly Names for Audio Endpoint Devices.
GetPinNamemethod only works with endpoints that do not have the Speakers friendly name. The following list shows the KS node type categories that are assigned the Speakers friendly name:
|Minimum supported client||Available in Windows 7 and later versions of Windows.|
|Header||portcls.h (include Portcls.h)|