PINT10_ALLOCATE_BUFFER funzione di callback (video.h)
La funzione Int10AllocateBuffer può essere usata per allocare un singolo blocco di memoria a 4 KB nel contesto di un altro thread. Dopo aver allocato il blocco di memoria, deve essere liberato prima che sia possibile 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. Questo valore deve essere uguale al valore nel membro Contesto della struttura di VIDEO_PORT_INT10_INTERFACE dopo che VideoPortQueryServices restituisce .
[out] Seg
Puntatore a una posizione di memoria che riceverà l'indirizzo 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 restituisce, questa posizione di memoria conterrà il valore 4096, se la memoria è stata effettivamente allocata.
Valore restituito
La funzione Int10AllocateBuffer restituisce NO_ERROR al successo. Restituisce STATUS_INSUFFICIENT_RESOURCES se il buffer è stato allocato in precedenza o se viene richiesta una dimensione del buffer maggiore di 4096 byte.
Commenti
La porta video implementa questa funzione, a cui è possibile accedere tramite un puntatore nella struttura VIDEO_PORT_INT10_INTERFACE .
Requisiti
| 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 |