IOCTL_SBAUD_GET_ENDPOINT_DESCRIPTOR IOCTL (sidebandaudio.h)
El controlador de audio emite el código de control de IOCTL_SBAUD_GET_ENDPOINT_DESCRIPTOR para obtener información sobre un punto de conexión de audio expuesto a través de la interfaz de dispositivo de audio de banda lateral.
Valor de índice de punto de conexión basado en 0 según el número de puntos de conexión de audio notificados por el IOCTL_SBAUD_GET_DEVICE_DESCRIPTOR.
Se trata de un valor de ULONG de 0 a (N-1), donde N es el número de puntos de conexión del dispositivo.
Tamaño de ULONG.
Búfer que contiene una estructura de SIDEBANDAUDIO_ENDPOINT_DESCRIPTOR seguida de cualquier otro dato al que hace referencia la estructura. Esto se devuelve si el tamaño del búfer de salida es suficiente y la solicitud se realiza correctamente. En concreto, el búfer incluye almacenamiento para la cadena a la que hace referencia el campo FriendlyName de la estructura de SIDEBANDAUDIO_ENDPOINT_DESCRIPTOR.
Tamaño de una estructura de SIDEBANDAUDIO_ENDPOINT_DESCRIPTOR y datos a los que se hace referencia.
Si la rutina se realiza correctamente, Status se establece en STATUS_SUCCESS y el miembro Information es el número de bytes que escribe la rutina en el búfer de salida.
Si Status está establecido en STATUS_BUFFER_TOO_SMALL, el controlador de audio debe leer el miembro Information para obtener el tamaño del búfer que el autor de la llamada debe asignar para esta solicitud.
Este IOCTL solo se puede llamar desde el modo kernel.
El controlador de audio envía esta solicitud para obtener información sobre un punto de conexión de banda lateral de audio habilitado. La información no cambia mientras la interfaz está habilitada, pero puede cambiar mientras la interfaz está deshabilitada. Por lo tanto, el controlador de audio envía esta solicitud poco después de detectar una interfaz de dispositivo habilitada y usa la información para crear una estructura de KSFILTER_DESCRIPTOR adecuada.
El controlador de audio envía esta solicitud una vez con un tamaño de búfer de salida de cero (0) para determinar el tamaño de búfer de salida necesario. En este caso, la solicitud se completará con estado STATUS_BUFFER_TOO_SMALL y establecerá el miembro Information en el tamaño de búfer necesario. A continuación, el controlador de audio asigna el espacio de almacenamiento necesario y envía la solicitud de nuevo.
Requisito | Valor |
---|---|
encabezado de | sidebandaudio.h |
SIDEBANDAUDIO_ENDPOINT_DESCRIPTOR