Método IMMDeviceEnumerator::UnregisterEndpointNotificationCallback (mmdeviceapi.h)

El método UnregisterEndpointNotificationCallback elimina el registro de una interfaz de notificación que el cliente registró en una llamada anterior al método IMMDeviceEnumerator::RegisterEndpointNotificationCallback .

Sintaxis

HRESULT UnregisterEndpointNotificationCallback(
  [in] IMMNotificationClient *pClient
);

Parámetros

[in] pClient

Puntero a la interfaz IMMNotificationClient del cliente. El cliente pasó este mismo puntero de interfaz al enumerador de dispositivos en una llamada anterior al método IMMDeviceEnumerator::RegisterEndpointNotificationCallback . Para obtener más información, vea la sección Comentarios.

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK. Si se produce un error, los códigos de retorno posibles incluyen, entre otros, los valores que se muestran en la tabla siguiente.

Comentarios

El cliente debe asegurarse de que el objeto IMMNotificationClient no se libere después de la llamada RegisterEndpointNotificationCallback y antes de llamar a UnregisterEndpointNotificationCallback. Estos métodos no llaman a las implementaciones IMMNotificationClient::AddRef e IMMNotificationClient::Release del cliente. El cliente es responsable de mantener el recuento de referencias del objeto IMMNotificationClient . El cliente debe incrementar el recuento si la llamada RegisterEndpointNotificationCallback se realiza correctamente y libera la referencia final solo después de llamar a UnregisterEndpointNotificationCallback o implementar algún otro mecanismo para asegurarse de que el objeto no se elimina antes de llamar a UnregisterEndpointNotificationCallback . De lo contrario, la aplicación filtra los recursos mantenidos por IMMNotificationClient y cualquier otro objeto que se implemente en el mismo contenedor.

Para obtener más información sobre los métodos AddRef y Release, consulte la explicación de la interfaz IUnknown en la documentación de Windows SDK.

Requisitos

Consulte también

IMMDeviceEnumerator (Interfaz)

IMMDeviceEnumerator::RegisterEndpointNotificationCallback

Interfaz IMMNotificationClient