PFREE_DMA_BUFFER_WITH_NOTIFICATION función de devolución de llamada (hdaudio.h)
La rutina FreeDmaBufferWithNotification libera un búfer DMA asignado previamente por una llamada a AllocateDmaBufferWithNotification.
El tipo de puntero de función para una rutina FreeDmaBufferWithNotification se define de la manera siguiente.
Sintaxis
PFREE_DMA_BUFFER_WITH_NOTIFICATION PfreeDmaBufferWithNotification;
NTSTATUS PfreeDmaBufferWithNotification(
[in] PVOID _context,
[in] HANDLE Handle,
[in] PMDL BufferMdl,
[in] SIZE_T BufferSize
)
{...}
Parámetros
[in] _context
Especifica el valor de contexto del miembro Context de la estructura HDAUDIO_BUS_INTERFACE_V2.
[in] Handle
Identificador que identifica el motor DMA. Este valor de identificador se obtuvo de una llamada anterior a AllocateCaptureDmaEngine o AllocateRenderDmaEngine.
[in] BufferMdl
Puntero al MDL del búfer. Este valor se obtuvo de una llamada anterior a AllocateDmaBufferWithNotification.
[in] BufferSize
Tamaño del búfer que se va a liberar. Este valor se obtuvo de una llamada anterior a AllocateDmaBufferWithNotification.
Valor devuelto
FreeDmaBufferWithNotification devuelve STATUS_SUCCESS si la llamada se realiza correctamente. De lo contrario, FreeDmaBufferWithNotification devuelve un código de error adecuado. En la tabla siguiente se muestran algunos de los posibles códigos de error de devolución.
| Código devuelto | Descripción |
|---|---|
|
Indica que el autor de la llamada se está ejecutando en un IRQL demasiado alto. |
|
Indica que el identificador de valor de parámetro no es válido. |
|
Indica que la secuencia no está en el estado de restablecimiento o que actualmente no se asigna ningún búfer para el motor DMA. |
Observaciones
La rutina FreeDmaBufferWithNotification se usa junto con la rutina AllocateDmaBufferWithNotification. Estas dos rutinas solo están disponibles en la versión HDAUDIO_BUS_INTERFACE_V2 de hd Audio DDI.
Los autores de llamadas de FreeDmaBufferWithNotification deben ejecutarse en irQL PASSIVE_LEVEL.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Disponible en Windows Vista y versiones posteriores de Windows. |
| de la plataforma de destino de | Escritorio |
| encabezado de | hdaudio.h (incluya Hdaudio.h) |
| irQL | PASSIVE_LEVEL |