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.
| Código devuelto | Descripción |
|---|---|
|
El parámetro pNotify es NULL. |
|
No se encontró la interfaz de notificación especificada. |
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
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | mmdeviceapi.h |
Consulte también
IMMDeviceEnumerator (Interfaz)