PDX_TRANSFER Rückruffunktion (dxmini.h)

Artikel
08/23/2023

Die DxTransfer-Rückruffunktion informiert den Treiber über den Bus master Daten von einer Oberfläche in den puffer, der in der Speicherdeskriptorliste (Memory Descriptor List, MDL) angegeben ist.

Syntax

PDX_TRANSFER PdxTransfer;

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

Parameter

unnamedParam1

Verweist auf die Geräteerweiterung des Miniporttreibers.

unnamedParam2

Verweist auf eine DDTRANSFERININFO-Struktur , die die Übertragungsinformationen für die Oberfläche enthält.

unnamedParam3

Verweist auf eine DDTRANSFEROUTINFO-Struktur , die die Polarität des zu erfassenden Felds enthält.

Rückgabewert

DxTransfer gibt bei Erfolg DX_OK zurück. Andernfalls wird einer der folgenden Fehlerwerte zurückgegeben:

Hinweise

Die MDL ist in der WDM-Dokumentation definiert.

Wie im folgenden Codebeispiel gezeigt, kann der Video-Miniporttreiber den Zeiger auf die MDL im lpDestMDL-Member der DDTRANSFERININFO-Struktur am TransferInInfo-Parameter verwenden, um Daten master auf die physischen Speicherseiten zu übertragen, die einen verteilten Puffer bilden:

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];
    }
}

Weitere Informationen finden Sie unter den Kernelmodusmakros ADDRESS_AND_SIZE_TO_SPAN_PAGES, MmGetMdlByteCount, MmGetMdlPfnArray und MmGetMdlVirtualAddress.

DxTransfer wird zur Hardwareunterbrechungszeit aufgerufen. Dies bedeutet, dass der Treiber nicht warten kann, bis ein vorheriger Bus master abgeschlossen ist, und er kann keine Funktionen aufrufen, die zur Unterbrechungszeit nicht sicher sind (d. h. die meisten davon).

Darüber hinaus sollte der Treiber den Aufruf nicht fehlschlagen, nur weil die Hardware derzeit ausgelastet ist. Stattdessen sollte der Treiber eine interne Warteschlange verwalten.