función DRV_QUERYDEVICEINTERFACESIZE
El DRV_QUERYDEVICEINTERFACESIZE mensaje consulta el tamaño del búfer necesario para contener el nombre de la interfaz del dispositivo.
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_QUERYDEVICEINTERFACESIZE cuando llama a xxxMessage para procesar este mensaje de dispositivo.dwParam1
Puntero al tamaño del búfer. Este parámetro apunta a una variable ULONG en la que la función escribe el tamaño de búfer necesario en bytes. El tamaño incluye espacio de almacenamiento para el valor NULL de terminación de la cadena de nombre. El tamaño es cero si el identificador de dispositivo identifica un dispositivo que no tiene ninguna interfaz de dispositivo.dwParam2
Sin usar. Establezca este parámetro en cero.
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
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.
El tamaño del búfer recuperado por este mensaje se expresa como un recuento de bytes. Especifica el tamaño del búfer necesario para contener la cadena Unicode terminada en null que contiene el nombre de la interfaz del dispositivo. El autor de la llamada asigna un búfer del tamaño especificado y usa el mensaje DRV_QUERYDEVICEINTERFACE para recuperar la cadena de nombre de la interfaz del dispositivo.
Para obtener más información, vea Obtener un nombre de interfaz de dispositivo.
Requisitos
Plataforma de destino |
Escritorio |
Versión |
Compatible con los sistemas operativos Microsoft Windows Me y Windows 2000 y versiones posteriores. |
Encabezado |
Mmddk.h (incluye Mmddk.h) |
Consulte también
Obtener un nombre de interfaz de dispositivo