IKsDeviceFunctions::RegisterAdapterObjectEx 메서드(ks.h)

IKsDeviceFunctions::RegisterAdapterObjectEx 메서드는 AVStream에 DMA 어댑터 개체를 등록합니다. Win64 플랫폼용으로 컴파일된 모든 드라이버는 KsDeviceRegisterAdapterObject 대신 이 메서드를 사용해야 합니다.

구문

NTSTATUS RegisterAdapterObjectEx(
  [in] PADAPTER_OBJECT     AdapterObject,
  [in] PDEVICE_DESCRIPTION DeviceDescription,
  [in] ULONG               NumberOfMapRegisters,
  [in] ULONG               MaxMappingsByteCount,
  [in] ULONG               MappingTableStride
);

매개 변수

[in] AdapterObject

디바이스의 ADAPTER_OBJECT 대한 포인터입니다. RegisterAdapterObjectEx를 호출하기 전에 IoGetDmaAdapter를 통해 획득해야 합니다.

[in] DeviceDescription

호출자가 DMA 개체를 등록하는 물리적 디바이스의 특성을 설명하는 형식 DEVICE_DESCRIPTION 구조체에 대한 포인터입니다.

[in] NumberOfMapRegisters

IoGetDmaAdapter에 대한 미니드라이버 호출에서 반환된 지도 레지스터 수를 지정합니다.

[in] MaxMappingsByteCount

디바이스가 단일 매핑에 대해 처리할 수 있는 최대 바이트 수를 지정합니다. AVStream은 연속된 물리적 메모리의 큰 청크를 DMA 전송의 개별 매핑에 크기 제한을 적용하는 디바이스의 여러 분산/수집 요소로 자동으로 분할할 수 있습니다. KsDeviceRegisterAdapterObject 참조 페이지에서 MaxMappingsByteCount에 대한 중요한 추가 정보를 참조하세요.

[in] MappingTableStride

매핑 테이블의 각 항목에 필요한 바이트 수를 지정합니다. 이 값은 최소한 sizeof (KSMAPPING)여야 하며 필요한 만큼 클 수 있습니다.

미니드라이버에서 컨텍스트 정보로 추가 공간을 사용할 수 있습니다.

반환 값

RegisterAdapterObjectEx 는 DMA 개체가 성공적으로 등록되면 STATUS_SUCCESS 반환합니다. 메서드는 충분한 메모리를 사용할 수 없는 경우 STATUS_INSUFFICIENT_RESOURCES 반환합니다.

설명

또한 64비트 AVStream 드라이버에서 DMA 지원을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Microsoft Windows Server 2003 SP1(서비스 팩 1) 이상 버전의 Windows에서 사용할 수 있습니다.
대상 플랫폼	유니버설
헤더	ks.h(Ks.h 포함)

추가 정보

KsDeviceRegisterAdapterObject