IPortClsNotifications::AllocNotificationBuffer-Methode (portcls.h)

Artikel
02/07/2025

Weist einen Puffer der angegebenen Größe im angegebenen Speicherpool zur Verwendung beim Senden von Benachrichtigungen zu, um die Kommunikation zwischen Audiomodulen und UWP-Apps zu ermöglichen.

Weitere Informationen zu Audiomodulen finden Sie unter Implementing Audio Module Discovery.

Syntax

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

Parameter

[in] PoolType

Gibt den Typ des Speicherpools an, dem das Objekt zugeordnet werden soll (siehe POOL_TYPE). Die empfohlenen Werte sind NonPagedPoolNx oder PagedPool. Die Auswahl des Speicherpooltyps hängt auch von der IRQL-Ebene ab. Wenn sie bei DISPATCH_LEVEL ausgeführt wird, muss der Speicher nicht ausgelagert werden.

[in] NumberOfBytes

Anzahl der zuzuordnenden Bytes.

[out] NotificationBuffer

Zeigen Sie auf eine PCNOTIFICATION_BUFFER, die die Methode die Adresse der zugewiesenen Benachrichtigung schreibt.

Rückgabewert

STATUS_SUCCESS – Der Treiber konnte den Benachrichtigungspuffer zuordnen.

STATUS_INVALID_PARAMETER – Der Treiber gibt diesen Fehler zurück, wenn er einen anderen ungültigen Parameter findet, abgesehen von den spezifischen Fällen für andere Fehlerstatusinstanzen.

Zusätzliche Standardstatuscodes können zurückgegeben werden. Beispielsweise wird STATUS_INSUFFICIENT_RESOURCES zurückgegeben, wenn es nicht möglich ist, den erforderlichen Puffer zuzuweisen.

Bemerkungen

Aufrufer von AllocNotificationBuffer müssen unter IRQL-<= DISPATCH_LEVEL ausgeführt werden. Wenn ein Treiberschreiber diese Routine bei IRQL = DISPATCH_LEVEL aufruft, muss die NotificationStructure aus nicht seitengebundenem Speicher zugewiesen werden.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar in Windows 10, Version 1703 und höheren Versionen von Windows.
Zielplattform-	Universal
Header-	portcls.h (include Portcls.h)
Library	Portcls.lib
IRQL-	<= DISPATCH_LEVEL (siehe Abschnitt "Hinweise")

Siehe auch

IPortClsNotifications-

Freigeben über