PFNKSPININITIALIZEALLOCATOR-Rückruffunktion (ks.h)
Die AVStrMiniInitializeAllocator-Routine eines AVStream-Minidrivers initialisiert einen Zuteilungsvorgang, 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 Zuordnungsgeber zugeordnet werden soll.
[in] AllocatorFraming
Zeiger auf eine KSALLOCATOR_FRAMING-Struktur , die die Rahmenanforderungen beschreibt, die der Zuordnungsgeber verwenden soll.
[out] Context
Zeiger auf einen Kontext für den Zuweisungsator, der als Parameter an die anderen Routinen für diese Struktur übergeben wird. Der Treiber könnte z. B. Pin- oder Allocator-Framingstrukturen für einen späteren Verweis durch die anderen Rückrufroutinen speichern. Beachten Sie, dass andere Routinen für KSALLOCATOR_DISPATCH mindestens eine indirekte Möglichkeit haben müssen, auf Pin zu verweisen. (Für instance muss AVStrMiniAllocate auf die AllocatorFraming-Informationen für Pin zugreifen können, und Context ist der einzige Parameter, der von AVStream übergeben wird.)
Rückgabewert
AVStrMiniInitializeAllocator sollte STATUS_SUCCESS oder den Fehlercode zurückgeben, den er beim Erstellen des Zuteilungsversuchs erhalten hat.
Hinweise
Der Minidriver gibt die Adresse dieser Routine im Element InitializeAllocator der KSALLOCATOR_DISPATCH-Struktur an. Der Minidriver übergibt diese Struktur an den Klassentreiber in KSPIN_DISPATCH.
Beachten Sie, dass Kernelmodusverteiler keine Frames zuordnen können, die schließlich den Benutzermodus erreichen könnten.
AVStream ruft AVStrMiniInitializeAllocator auf, um die angegebene Zuordnung zu initialisieren. Der Handler für diese Routine sollte sich auf die Verarbeitung der Speicherzuordnung und freier Anforderungen vorbereiten.
Weitere Informationen finden Sie unter KS-Zuweisungen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Microsoft Windows XP und höheren Betriebssystemen und DirectX 8.0 und höher DirectX-Versionen. |
| Zielplattform | Desktop |
| Kopfzeile | ks.h (einschließlich Ks.h) |