Metodo IMMDeviceEnumerator::UnregisterEndpointNotificationCallback (mmdeviceapi.h)
Il metodo UnregisterEndpointNotificationCallback elimina la registrazione di un'interfaccia di notifica registrata nel client registrato in una chiamata precedente al metodo IMMDeviceEnumerator::RegisterEndpointNotificationCallback .
Sintassi
HRESULT UnregisterEndpointNotificationCallback(
[in] IMMNotificationClient *pClient
);
Parametri
[in] pClient
Puntatore all'interfaccia IMMNotificationClient del client. Il client ha passato questo stesso puntatore dell'interfaccia all'enumeratore del dispositivo in una chiamata precedente al metodo IMMDeviceEnumerator::RegisterEndpointNotificationCallback . Per altre informazioni, vedere la sezione Osservazioni.
Valore restituito
Se il metodo ha esito positivo, viene restituito S_OK. Se ha esito negativo, i codici restituiti possibili includono, ma non sono limitati a, i valori visualizzati nella tabella seguente.
Codice restituito | Descrizione |
---|---|
|
Il parametro pNotify è NULL. |
|
L'interfaccia di notifica specificata non è stata trovata. |
Commenti
Il client deve assicurarsi che l'oggetto IMMNotificationClient non venga rilasciato dopo la chiamata RegisterEndpointNotificationCallback e prima di chiamare UnregisterEndpointNotificationCallback. Questi metodi non chiamano le implementazioni IMMNotificationClient::AddRef e IMMNotificationClient::Release. Il client è responsabile della gestione del conteggio dei riferimenti dell'oggetto IMMNotificationClient . Il client deve incrementare il conteggio se la chiamata RegisterEndpointNotificationCallback riesce e rilascia il riferimento finale solo dopo aver chiamato UnregisterEndpointNotificationCallback o implementare un altro meccanismo per assicurarsi che l'oggetto non venga eliminato prima che venga chiamato UnregisterEndpointNotificationCallback . In caso contrario, l'applicazione perde le risorse mantenute da IMMNotificationClient e qualsiasi altro oggetto implementato nello stesso contenitore.
Per altre informazioni sui metodi AddRef e Release, vedere la discussione sull'interfaccia IUnknown nella documentazione di Windows SDK.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Windows Vista [solo app desktop] |
Server minimo supportato | Windows Server 2008 [solo app desktop] |
Piattaforma di destinazione | Windows |
Intestazione | mmdeviceapi.h |
Vedi anche
Interfaccia IMMDeviceEnumerator