PDX_TRANSFER funzione di callback (dxmini.h)

Articolo
08/23/2023

La funzione di callback DxTransfer informa il driver per il bus dei dati master da una superficie al buffer specificato nell'elenco dei descrittori di memoria (MDL).

Sintassi

PDX_TRANSFER PdxTransfer;

DWORD PdxTransfer(
  PVOID unnamedParam1,
  PDDTRANSFERININFO unnamedParam2,
  PDDTRANSFEROUTINFO unnamedParam3
)
{...}

Parametri

unnamedParam1

Punta all'estensione del dispositivo del driver miniport.

unnamedParam2

Punta a una struttura DDTRANSFERININFO che contiene le informazioni di trasferimento per la superficie.

unnamedParam3

Punta a una struttura DDTRANSFEROUTINFO che contiene la polarità del campo acquisito.

Valore restituito

DxTransfer restituisce DX_OK se ha esito positivo; in caso contrario, restituisce uno dei valori di errore seguenti:

Commenti

Il linguaggio MDL è definito nella documentazione di WDM .

Come illustrato nell'esempio di codice seguente, il driver miniport video può usare il puntatore al MDL nel membro lpDestMDL della struttura DDTRANSFERININFO nel parametro TransferInInfo per i dati master del bus nelle pagine di memoria fisica che costituiscono un buffer a dispersione:

DWORD 
DxTransfer(
    DEVICE_EXT *pDeviceExt, 
    PDDTRANSFERININFO pTransferInInfo, 
    PDDTRANSFEROUTINFO pTransferOutInfo
    )
{
    PMDL pMdl;
    UINT uiNbPages;
    PPFN_NUMBER pPages;
    PVOID MappedSystemVa;
    ULONG ByteCount;

    pMdl = pTransferInInfo->lpDestMDL;
    MappedSystemVa = MmGetMdlVirtualAddress(pMdl);
    ByteCount = MmGetMdlByteCount(pMdl);
    uiNbPages = ADDRESS_AND_SIZE_TO_SPAN_PAGES(MappedSystemVa,
                                               ByteCount);
    pPages = MmGetMdlPfnArray(pMdl)
    for (i=0; i<uiNbPages; i++) {
        //
        // Transfer to page[i]
        //
        pPages[i];
    }
}

Per altre informazioni, vedere le macro ADDRESS_AND_SIZE_TO_SPAN_PAGES, MmGetMdlByteCount, MmGetMdlPfnArray e MmGetMdlVirtualAddress in modalità kernel.

DxTransfer viene chiamato in fase di interruzione hardware. Ciò significa che il conducente non può attendere il completamento di un master bus precedente e non può chiamare funzioni che non sono sicure per chiamare in fase di interruzione (ovvero la maggior parte di esse).

Inoltre, il driver non deve interrompere la chiamata solo perché l'hardware è attualmente occupato. Al contrario, il driver deve gestire una coda interna.