Método IPortClsNotifications::AllocNotificationBuffer (portcls.h)

Asigna un búfer del tamaño especificado, en el grupo de memoria especificado, para usarlo en el envío de notificaciones, para permitir las comunicaciones entre módulos de audio y aplicaciones para UWP.

Para obtener más información sobre los módulos de audio, consulte Implementación de la detección de módulos de audio.

Sintaxis

NTSTATUS AllocNotificationBuffer(
  [in]  POOL_TYPE              PoolType,
  [in]  USHORT                 NumberOfBytes,
  [out] PPCNOTIFICATION_BUFFER *NotificationBuffer
);

Parámetros

[in] PoolType

Especifica el tipo de grupo de memoria desde el que se va a asignar el objeto (vea POOL_TYPE). Los valores recomendados son NonPagedPoolNx o PagedPool. La selección del tipo de grupo de memoria también depende del nivel IRQL. Si se ejecuta en DISPATCH_LEVEL la memoria debe no paginarse.

[in] NumberOfBytes

Número de bytes que se van a asignar.

[out] NotificationBuffer

Puntero a un PCNOTIFICATION_BUFFER que el método escribe la dirección de la notificación asignada.

Valor devuelto

STATUS_SUCCESS: el controlador pudo asignar el búfer de notificaciones.

STATUS_INVALID_PARAMETER: el controlador devuelve este error si encuentra algún otro parámetro no válido, aparte de los casos específicos de otras instancias de estado de error.

Se pueden devolver códigos de estado estándar adicionales. Por ejemplo, se devolverá STATUS_INSUFFICIENT_RESOURCES si no es posible asignar el búfer necesario.

Observaciones

Los autores de llamadas de AllocNotificationBuffer deben ejecutarse en IRQL <= DISPATCH_LEVEL. Si un escritor de controladores llama a esta rutina en IRQL = DISPATCH_LEVEL, notificationStructure debe asignarse desde la memoria no paginada.

Requisitos

Requisito	Valor
cliente mínimo admitido	Disponible en Windows 10, versión 1703 y versiones posteriores de Windows.
de la plataforma de destino de	Universal
encabezado de	portcls.h (incluya Portcls.h)
biblioteca de	Portcls.lib
irQL	<= DISPATCH_LEVEL (consulte la sección Comentarios)

Consulte también

IPortClsNotifications