PDD_VPORTCB_GETVPORTCONNECT funzione di callback (ddrawint.h)
La funzione callback DdVideoPortGetConnectInfo restituisce le connessioni supportate dall'oggetto VPE specificato.
Sintassi
PDD_VPORTCB_GETVPORTCONNECT PddVportcbGetvportconnect;
DWORD PddVportcbGetvportconnect(
PDD_GETVPORTCONNECTDATA unnamedParam1
)
{...}
Parametri
unnamedParam1
Punta a una struttura DD_GETVPORTCONNECTDATA contenente le informazioni necessarie per il driver per restituire i dati di connessione dell'oggetto VPE.
Valore restituito
DdVideoPortGetConnectInfo restituisce uno dei codici di callback seguenti:
Commenti
DdVideoPortGetConnectInfo deve essere implementato nei driver DirectDraw che supportano VPE.
DirectDraw chiama DdVideoPortGetConnectInfo per ottenere il numero di connessioni supportate dall'oggetto VPE specificato e le caratteristiche di ogni connessione. DdVideoPortGetConnectInfo viene chiamato due volte per l'oggetto VPE specificato:
- Nella prima chiamata, il membro lpConnect della struttura DD_GETVPORTCONNECTDATA in lpGetConnect è NULL. Il driver deve scrivere il numero di connessioni supportate dall'oggetto VPE nel membro dwNumEntries di DD_GETVPORTCONNECTDATA. Al ritorno, DirectDraw allocherà questo numero di strutture DDVIDEOPORTCONNECT per passare la seconda chiamata a DdVideoPortGetConnectInfo.
- Nella seconda chiamata lpConnect punta alla matrice di strutture DDVIDEOPORTCONNECT allocate. Il driver deve compilare ogni struttura per descrivere ogni connessione supportata dall'oggetto VPE. Il driver deve restituire anche il numero di connessioni supportate in dwNumEntries. Si noti che il driver è garantito che il buffer a cui i punti lpConnect siano sufficienti per contenere le informazioni di connessione richieste.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Desktop |
| Intestazione | ddrawint.h (include Winddi.h) |