PFNKSPININITIALIZEALLOCATOR-Rückruffunktion (ks.h)
Die AVStrMiniInitializeAllocator Routine von AVStream minidriver initialisiert einen Allocator, der einem Pin zugeordnet wird.
Syntax
PFNKSPININITIALIZEALLOCATOR Pfnkspininitializeallocator;
NTSTATUS Pfnkspininitializeallocator(
[in] PKSPIN Pin,
[in] PKSALLOCATOR_FRAMING AllocatorFraming,
[out] PVOID *Context
)
{...}
Parameter
[in] Pin
Zeiger auf eine KSPIN- Struktur, die den Pin beschreibt, dem der Allocator zugeordnet werden soll.
[in] AllocatorFraming
Zeigen Sie auf eine KSALLOCATOR_FRAMING Struktur, die die Rahmenanforderungen beschreibt, die der Allocator verwenden sollte.
[out] Context
Zeiger auf einen Kontext für den Allocator, der als Parameter an die anderen Routinen für diese Struktur übergeben wird. Beispielsweise könnte der Treiber Pin- oder Allocator framing-Strukturen speichern, um später von den anderen Rückrufroutinen referenziert zu werden. Beachten Sie, dass andere Routinen für KSALLOCATOR_DISPATCH mindestens eine indirekte Möglichkeit zum Verweisen auf Pin-haben müssen. (Beispielsweise muss AVStrMiniAllocate auf die AllocatorFraming- Informationen für Pinzugreifen können, und Context ist der einzige Parameter, den AVStream übergeben wird.)
Rückgabewert
AVStrMiniInitializeAllocator- sollte STATUS_SUCCESS oder den Fehlercode zurückgeben, den er empfangen hat, um den Allocator zu erstellen.
Bemerkungen
Der Minidriver gibt die Adresse dieser Routine im InitializeAllocator Mitglied der KSALLOCATOR_DISPATCH Struktur an. Der Minidriver übergibt diese Struktur an den Klassentreiber in KSPIN_DISPATCH.
Beachten Sie, dass Kernelmodus-Allocatoren keine Frames zuordnen können, die letztendlich den Benutzermodus erreichen könnten.
AVStream ruft AVStrMiniInitializeAllocator- auf, um den angegebenen Allocator zu initialisieren. Der Handler für diese Routine sollte sich darauf vorbereiten, Speicherzuweisungen und kostenlose Anforderungen zu verarbeiten.
Weitere Informationen finden Sie unter KS Allocators.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Microsoft Windows XP und höheren Betriebssystemen und DirectX 8.0 und höher directX-Versionen. |
| Zielplattform- | Desktop |
| Header- | ks.h (enthalten Ks.h) |