función DRV_QUERYDEVICEINTERFACE
El DRV_QUERYDEVICEINTERFACE mensaje consulta el nombre de la interfaz del dispositivo de un dispositivo waveIn, waveOut, midiIn, midiOut o dispositivo mezclador .
Sintaxis
DWORD xxxMessage(
UINT uDeviceID,
UINT uMsg,
DWORD_PTR dwParam1,
DWORD_PTR dwParam2
);
Parámetros
uDeviceID
Especifica el identificador del dispositivo de destino.uMsg
El autor de la llamada establece este parámetro en DRV_QUERYDEVICEINTERFACE cuando llama a xxxMessage para procesar este mensaje de dispositivo.dwParam1
Puntero a un búfer asignado por el autor de la llamada en el que la función escribe una cadena Unicode terminada en null que contiene el nombre de la interfaz del dispositivo. Si el dispositivo no tiene ninguna interfaz de dispositivo, la longitud de la cadena es cero.dwParam2
Especifica el tamaño del búfer en bytes. Se trata de un parámetro de entrada para la función . El autor de la llamada debe especificar un tamaño mayor o igual que el tamaño del búfer recuperado por el mensaje DRV_QUERYDEVICEINTERFACESIZE .
Valor devuelto
La función xxxMessage devuelve MMSYSERR_NOERROR si el mensaje se controla correctamente. De lo contrario, devuelve un código de error adecuado.
Comentarios
El mensaje de DRV_QUERYDEVICEINTERFACE se admite en Windows Me y Windows 2000 y versiones posteriores. Este mensaje solo es válido para las funciones waveInMessage, waveOutMessage, midiInMessage, midiOutMessage y mixerMessage . El sistema intercepta este mensaje y devuelve el valor adecuado sin enviar el mensaje al controlador del dispositivo. Para obtener información general sobre las funciones xxxMessage interceptadas por el sistema, consulte Mensajes de dispositivo interceptados por el sistema.
Las dos constantes de mensaje siguientes se usan conjuntamente con el fin de obtener nombres de interfaz de dispositivo:
DRV_QUERYDEVICEINTERFACESIZE
DRV_QUERYDEVICEINTERFACE
El primer mensaje obtiene el tamaño en bytes del búfer necesario para contener la cadena que contiene el nombre de la interfaz del dispositivo. El segundo mensaje recupera la cadena de nombre en un búfer del tamaño necesario.
Para obtener más información, vea Obtener un nombre de interfaz de dispositivo.
Requisitos
Plataforma de destino |
Escritorio |
Encabezado |
Mmddk.h (incluye Mmddk.h) |