Compartilhar via


Método IMMNotificationClient::OnDeviceStateChanged (mmdeviceapi.h)

O método OnDeviceStateChanged indica que o estado de um dispositivo de ponto de extremidade de áudio foi alterado.

Sintaxe

HRESULT OnDeviceStateChanged(
  [in] LPCWSTR pwstrDeviceId,
  [in] DWORD   dwNewState
);

Parâmetros

[in] pwstrDeviceId

Ponteiro para a cadeia de caracteres de ID do ponto de extremidade que identifica o dispositivo de ponto de extremidade de áudio. Esse parâmetro aponta para uma cadeia de caracteres largos terminada em nulo que contém a ID do ponto de extremidade. A cadeia de caracteres permanece válida durante a chamada.

[in] dwNewState

Especifica o novo estado do dispositivo de ponto de extremidade. O valor desse parâmetro é uma das seguintes constantes DEVICE_STATE_XXX :

DEVICE_STATE_ACTIVE

DEVICE_STATE_DISABLED

DEVICE_STATE_NOTPRESENT

DEVICE_STATE_UNPLUGGED

Valor retornado

Se o método for bem-sucedido, retornará S_OK. Se falhar, retornará um código de erro.

Comentários

Para obter um exemplo de código que implementa o método OnDeviceStateChanged , consulte Eventos de dispositivo.

Requisitos

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho mmdeviceapi.h

Confira também

IMMNotificationClient Interface