IPortClsNotifications::AllocNotificationBuffer-Methode (portcls.h)
Weist einen Puffer der angegebenen Größe im angegebenen Speicherpool für die Verwendung beim Senden von Benachrichtigungen zu, um die Kommunikation zwischen Audiomodulen und UWP-Apps zu ermöglichen.
Weitere Informationen zu Audiomodulen finden Sie unter Implementieren der Audiomodulermittlung.
Syntax
NTSTATUS AllocNotificationBuffer(
[in] POOL_TYPE PoolType,
[in] USHORT NumberOfBytes,
[out] PPCNOTIFICATION_BUFFER *NotificationBuffer
);
Parameter
[in] PoolType
Gibt den Typ des Speicherpools an, aus 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. Bei Ausführung auf DISPATCH_LEVEL muss der Arbeitsspeicher nicht ausgelagert sein.
[in] NumberOfBytes
Anzahl der zuzuordnenden Bytes.
[out] NotificationBuffer
Zeiger auf einen PCNOTIFICATION_BUFFER , bei dem 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 Parameter ungültig findet, abgesehen von den spezifischen Fällen für andere Fehler status Instanzen.
Es können zusätzliche Standard-status-Codes zurückgegeben werden. Beispielsweise werden STATUS_INSUFFICIENT_RESOURCES zurückgegeben, wenn es nicht möglich ist, den erforderlichen Puffer zuzuweisen.
Hinweise
Aufrufer von AllocNotificationBuffer müssen unter IRQL <= DISPATCH_LEVEL ausgeführt werden. Wenn ein Treiberschreiber diese Routine unter IRQL = DISPATCH_LEVEL aufruft, muss die NotificationStructure aus dem nicht ausgestellten Arbeitsspeicher zugeordnet werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows 10 Version 1703 und höher von Windows. |
| Zielplattform | Universell |
| Header | portcls.h (include Portcls.h) |
| Bibliothek | Portcls.lib |
| IRQL | <= DISPATCH_LEVEL (siehe Abschnitt Hinweise) |