Funzione VideoPortLockPages (video.h)

Articolo
08/08/2023

La funzione VideoPortLockPages è obsoleta in Windows 2000 e versioni successive. Usare VideoPortLockBuffer al posto di questa funzione.

VideoPortLockPages blocca la memoria virtuale specificata e può eseguire parte o tutto il trasferimento DMA.

Sintassi

VIDEOPORT_DEPRECATED VIDEOPORT_API BOOLEAN VideoPortLockPages(
  [in]      IN PVOID                     HwDeviceExtension,
  [in, out] IN OUT PVIDEO_REQUEST_PACKET pVrp,
  [in]      IN PEVENT                    pUEvent,
  [in]      IN PEVENT                    pDisplayEvent,
  [in]      IN DMA_FLAGS                 DmaFlags
);

Parametri

[in] HwDeviceExtension

Puntatore all'estensione del dispositivo del driver miniport.

[in, out] pVrp

Puntatore a una struttura VIDEO_REQUEST_PACKET . Il driver miniport deve avere impostato InputBuffer e InputBufferLength per contenere l'indirizzo virtuale e le dimensioni in byte, rispettivamente, della memoria da bloccare per il trasferimento. Questa memoria è stata allocata dal driver di visualizzazione e passata al driver miniport tramite un IOCTL. La porta video restituisce rispettivamente un puntatore a e le dimensioni in byte dell'elenco di dispersione/raccolta in OutputBuffer e OutputBufferLength.

[in] pUEvent

Puntatore a un evento utente mappato che deve essere impostato dal driver miniport o NULL. L'evento utente è stato mappato dal driver visualizzato e passato al driver miniport tramite un IOCTL.

[in] pDisplayEvent

Puntatore a un evento che deve essere impostato dal driver miniport o NULL. Questo evento è stato creato e ricevuto dal driver di visualizzazione tramite un IOCTL.

[in] DmaFlags

Specifica l'azione da eseguire. Questo parametro deve essere uno dei valori seguenti:

Valore	Significato
VideoPortDmaInitOnly	VideoPortLockPages blocca la memoria richiesta.
VideoPortKeepPagesLocked	VideoPortLockPages non esegue alcuna azione.
VideoPortUnlockAfterDma	VideoPortLockPages non esegue alcuna azione.

Valore restituito

VideoPortLockPages restituisce TRUE al completamento dell'azione richiesta. Restituisce FALSE se il parametro DmaFlags non è uguale a VideoPortDmaInitOnly.

Commenti

Vedere Bus-Master DMA in Video Miniport Driver per informazioni sui trasferimenti DMA basati su pacchetti e common-buffer.

Non è possibile chiamare VideoPortLockPages da un ISR o da un DPC.

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)
Libreria	Videoprt.lib
DLL	Videoprt.sys

Vedi anche

VideoPortLockBuffer

Condividi tramite