Funzione di callback PFNKSPININITIALIZEALLOCATOR (ks.h)
La routine AVStrMiniInitializeAllocator di AVStream minidriver inizializza un allocatore che verrà associato a un pin.
Sintassi
PFNKSPININITIALIZEALLOCATOR Pfnkspininitializeallocator;
NTSTATUS Pfnkspininitializeallocator(
[in] PKSPIN Pin,
[in] PKSALLOCATOR_FRAMING AllocatorFraming,
[out] PVOID *Context
)
{...}
Parametri
[in] Pin
Puntatore a una struttura KSPIN che descrive il pin a cui deve essere associato l'allocatore.
[in] AllocatorFraming
Puntatore a una struttura KSALLOCATOR_FRAMING che descrive i requisiti di frame che l'allocatore deve usare.
[out] Context
Puntatore a un contesto per l'allocatore che verrà passato come parametro alle altre routine per questa struttura. Ad esempio, il driver potrebbe archiviare strutture di frame pin o allocator per un riferimento successivo da parte delle altre routine di callback. Si noti che altre routine per KSALLOCATOR_DISPATCH devono avere almeno un modo indiretto di fare riferimento a Pin. Ad esempio, AVStrMiniAllocate dovrà essere in grado di accedere alle informazioni allocatorFraming per Pin e Context è l'unico parametro che AVStream passerà.
Valore restituito
AVStrMiniInitializeAllocator deve restituire STATUS_SUCCESS o il codice di errore ricevuto tentando di creare l'allocatore.
Commenti
Il minidriver specifica l'indirizzo di questa routine nel membro InitializeAllocator della relativa struttura KSALLOCATOR_DISPATCH . Il minidriver passa questa struttura al driver di classe in KSPIN_DISPATCH.
Si noti che gli allocatori in modalità kernel non possono allocare frame che potrebbero raggiungere la modalità utente.
AVStream chiama AVStrMiniInitializeAllocator per inizializzare l'allocatore specificato. Il gestore per questa routine deve prepararsi per gestire l'allocazione della memoria e le richieste gratuite.
Per altre informazioni, vedere Allocatori KS.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile nei sistemi operativi Microsoft Windows XP e versioni successive e DirectX 8.0 e versioni successive di DirectX. |
| Piattaforma di destinazione | Desktop |
| Intestazione | ks.h (include Ks.h) |