IMiniportDMus::Init 메서드(dmusicks.h)
Init
메서드는 DMus 미니포트 개체를 초기화합니다.
통사론
NTSTATUS Init(
[in, optional] PUNKNOWN UnknownAdapter,
[in] PRESOURCELIST ResourceList,
[in] PPORTDMUS Port,
[out] PSERVICEGROUP *ServiceGroup
);
매개 변수
[in, optional] UnknownAdapter
미니포트 개체가 초기화되는 어댑터 개체의 IUnknown 인터페이스에 대한 포인터입니다. 이 매개 변수는 선택 사항이며 NULL지정할 수 있습니다. 자세한 내용은 다음 설명 섹션을 참조하세요.
[in] ResourceList
어댑터의 리소스 목록을 포함하는 IResourceList 개체에 대한 포인터입니다. 이 참조를 미니포트 드라이버에 전달한 후 포트 드라이버는 리소스 목록의 내용을 자유롭게 검사할 수 있지만 이 목록의 내용은 수정하지 않습니다.
[in] Port
포트 드라이버의 콜백 인터페이스를 제공하는 IPortDMus 개체에 대한 포인터입니다.
[out] ServiceGroup
서비스 그룹에 대한 출력 포인터입니다. 이 매개 변수는 메서드가 미니포트 드라이버의 서비스 그룹 개체의 IServiceGroup 인터페이스에 대한 포인터를 쓰는 호출자 할당 포인터 변수를 가리킵니다. 이 미니포트 드라이버가 IPortDMus::Notify호출에 사용하려는 서비스 그룹입니다.
반환 값
Init
호출에 성공하면 S_OK 반환합니다. 그렇지 않으면 메서드가 적절한 오류 코드를 반환합니다.
발언
pUnknownAdapter 매개 변수는 선택 사항입니다.
-
pUnknownAdapterNULL이 아닌경우
Init
메서드는 IInterruptSync 인터페이스에 대해 pUnknownAdapter 개체를 쿼리합니다. -
pUnknownAdapter NULL 경우
Init
메서드는 PcNewInterruptSync 호출하여 새 IInterruptSync 개체를 만듭니다. 이 경우 pResourceList를 리소스 목록이 새 IInterruptSync 개체에서 사용하는 인터럽트 리소스를 제공합니다.
Init
메서드를 호출하고 IInterruptSync 개체에서 RegisterServiceRoutine 메서드를 호출하여 ISR(미니포트 드라이버의 인터럽트 서비스 루틴)을 ISR 목록에 추가합니다. 어댑터 드라이버가 나중에 포트 개체를 해제하면 포트 드라이버는 IInterruptSync 개체에 대한 참조를 해제합니다.
pUnknownAdapter 및 pResourceList 매개 변수는 어댑터 드라이버가 이전에 IPortDMu s 개체의 Init
메서드에 매개 변수로 전달한 것과 동일한 포인터 값입니다(IPort::Init참조).
pUnknownAdapter, pResourceList, pPort및 ppServiceGroup 매개 변수는 COM 개체에 대한참조 계산 규칙을 따릅니다.
요구 사항
요구 | 값 |
---|---|
대상 플랫폼 | 바탕 화면 |
헤더 | dmusicks.h(Dmusicks.h 포함) |
IRQL | PASSIVE_LEVEL |