Metodo IKsDeviceFunctions::RegisterAdapterObjectEx (ks.h)
Il metodo IKsDeviceFunctions::RegisterAdapterObjectEx registra un oggetto adattatore DMA con AVStream. Tutti i driver compilati per le piattaforme Win64 devono usare questo metodo anziché KsDeviceRegisterAdapterObject.
Sintassi
NTSTATUS RegisterAdapterObjectEx(
[in] PADAPTER_OBJECT AdapterObject,
[in] PDEVICE_DESCRIPTION DeviceDescription,
[in] ULONG NumberOfMapRegisters,
[in] ULONG MaxMappingsByteCount,
[in] ULONG MappingTableStride
);
Parametri
[in] AdapterObject
Puntatore al ADAPTER_OBJECT per il dispositivo. Deve essere acquisito tramite IoGetDmaAdapter prima di chiamare RegisterAdapterObjectEx.
[in] DeviceDescription
Puntatore a una struttura di tipo DEVICE_DESCRIPTION che descrive gli attributi del dispositivo fisico per cui il chiamante registra un oggetto DMA.
[in] NumberOfMapRegisters
Specifica il numero di registri mappa restituiti dalla chiamata del minidriver a IoGetDmaAdapter.
[in] MaxMappingsByteCount
Specifica il numero massimo di byte che il dispositivo può gestire per un singolo mapping. Consente ad AVStream di suddividere automaticamente blocchi di grandi dimensioni di memoria fisica contigua in più elementi a dispersione/raccolta per i dispositivi che impongono un limite di dimensioni per i singoli mapping nei trasferimenti DMA. Vedere informazioni importanti su MaxMappingsByteCount nella pagina di riferimento KsDeviceRegisterAdapterObject .
[in] MappingTableStride
Specifica il numero di byte necessari per ogni voce della tabella di mapping. Questo valore deve essere almeno sizeof (KSMAPPING) e può essere il più grande necessario.
Lo spazio aggiuntivo può essere usato dal minidriver come informazioni di contesto.
Valore restituito
RegisterAdapterObjectEx restituisce STATUS_SUCCESS se l'oggetto DMA è stato registrato correttamente. Il metodo restituisce STATUS_INSUFFICIENT_RESOURCES se non è disponibile memoria sufficiente.
Commenti
Vedere anche Supporto di DMA nei driver AVStream a 64 bit.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Disponibile in Microsoft Windows Server 2003 con Service Pack 1 (SP1) e versioni successive di Windows. |
Piattaforma di destinazione | Universale |
Intestazione | ks.h (include Ks.h) |