PFNKSDEVICECREATE 콜백 함수(ks.h)

AVStream 미니드라이버의 AVStrMiniDeviceAdd 루틴은 AVStream의 PnP AddDevice 루틴이 완료되었음을 미니 드라이버에 알릴 수 있습니다.

구문

PFNKSDEVICECREATE Pfnksdevicecreate;

NTSTATUS Pfnksdevicecreate(
  [in] PKSDEVICE Device
)
{...}

매개 변수

[in] Device

방금 만든 FDO(기능 디바이스 개체)를 설명하는 KSDEVICE 구조체에 대한 포인터입니다.

반환 값

작업을 수행하려는 시도에서 반환된 STATUS_SUCCESS 또는 오류 코드를 반환해야 합니다. 미니드라이버가 실패 상태 반환하는 경우 관련 AddDevice 호출도 실패합니다. 자세한 내용은 아래 설명 섹션을 참조하세요.

설명

미니 드라이버는 해당 KSDEVICE_DISPATCH 구조체의 멤버 추가에서 이 루틴의 주소를 지정합니다.

AVStream은 KSDEVICE 초기화 시간에 기본 AddDevice 루틴에서 AVStrMiniDeviceAdd를 호출합니다. 이 루틴이 호출되는 시점에 WDM 디바이스 개체(DEVICE_OBJECT)가 생성되고 , KSDEVICE 구조가 인스턴스화되고 초기화되었으며, KS 디바이스 헤더가 할당되었습니다.

미니드라이버에서는 이 루틴을 사용하여 컨텍스트 정보를 AVStream 디바이스 개체와 연결하거나 디바이스 확장을 초기화할 수 있습니다.

이 루틴이 실패한 상태 코드를 반환하면 AVStream의 AddDevice 루틴이 실패합니다. STATUS_PENDING IRP가 포함되지 않으므로 법적 반환 코드가 아닙니다. 루틴은 IRQL = PASSIVE_LEVEL 에서만 호출됩니다.

이 루틴은 선택 사항입니다.

요구 사항

요구 사항
지원되는 최소 클라이언트 Microsoft Windows XP 이상 운영 체제 및 DirectX 8.0 이상 DirectX 버전에서 사용할 수 있습니다.
대상 플랫폼 데스크톱
머리글 ks.h(Ks.h 포함)
IRQL PASSIVE_LEVEL(설명 섹션 참조)

추가 정보

KSDEVICE_DISPATCH