PINT10_ALLOCATE_BUFFER funzione di callback (video.h)
La funzione int10AllocateBuffer può essere usata per allocare un singolo blocco di memoria di 4 KB nel contesto di un altro thread. Dopo aver allocato il blocco di memoria, è necessario liberarlo prima di poter allocare un altro blocco di memoria.
Sintassi
PINT10_ALLOCATE_BUFFER Pint10AllocateBuffer;
VP_STATUS Pint10AllocateBuffer(
[in] IN PVOID Context,
[out] OUT PUSHORT Seg,
[out] OUT PUSHORT Off,
[in, out] IN OUT PULONG Length
)
{...}
Parametri
[in] Context
Puntatore a un contesto definito dal driver della porta video per l'interfaccia. Deve corrispondere al valore nel membro Context della struttura VIDEO_PORT_INT10_INTERFACE dopo che VideoPortQueryServices restituisce.
[out] Seg
Puntatore a una posizione di memoria che riceverà l'indirizzo del segmento del buffer di memoria allocato.
[out] Off
Puntatore a una posizione di memoria che riceverà l'offset all'interno del segmento specificato da *Seg, del buffer di memoria allocato.
[in, out] Length
Puntatore a una posizione di memoria contenente la lunghezza, in byte, del buffer di memoria richiesto, che può essere di dimensioni pari a 4096. Quando la funzione viene restituita, questo percorso di memoria conterrà il valore 4096, indipendentemente dal fatto che la memoria sia stata effettivamente allocata.
Valore restituito
La funzione Int10AllocateBuffer restituisce NO_ERROR in caso di esito positivo. Restituisce STATUS_INSUFFICIENT_RESOURCES se il buffer è stato allocato in precedenza o se viene richiesta una dimensione del buffer maggiore di 4096 byte.
Osservazioni
La porta video implementa questa funzione, accessibile tramite un puntatore nella struttura VIDEO_PORT_INT10_INTERFACE.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile in Windows 2000 e versioni successive dei sistemi operativi Windows. |
| piattaforma di destinazione | Desktop |
| intestazione | video.h (includere Video.h) |
| IRQL | PASSIVE_LEVEL |